Windows 10/11 手动安装 WSL 避坑指南:不通过 Microsoft Store 也能玩转 Ubuntu
Windows 10/11 手动安装 WSL 终极指南无需商店的 Ubuntu 部署与多磁盘管理方案1. 为什么选择手动安装 WSL对于许多开发者而言Windows Subsystem for Linux (WSL) 已经成为日常开发不可或缺的工具。然而通过 Microsoft Store 安装的默认方式存在几个显著痛点C盘空间占用默认安装路径会消耗宝贵的系统盘空间网络依赖商店下载受限于网络环境和地区限制版本控制困难难以管理多个Linux发行版版本企业环境限制部分企业网络禁止访问Microsoft Store手动安装方案完美解决了这些问题同时带来额外优势自由选择安装位置可将Ubuntu部署到任何磁盘分区离线安装能力提前下载安装包避免网络问题版本灵活控制精确选择特定Ubuntu版本系统整洁性避免商店自动更新带来的不可控因素2. 环境准备与前置检查2.1 系统要求确认在开始前请确保您的系统满足以下最低要求组件要求操作系统Windows 10 版本 2004 及以上 (内部版本 19041 及以上) 或 Windows 11体系结构x64 或 ARM64虚拟化支持已在BIOS中启用验证方法按WinR输入winver查看系统版本在任务管理器 性能选项卡查看虚拟化状态2.2 启用WSL功能以管理员身份运行PowerShell执行以下命令# 启用WSL功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台功能WSL2必需 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart提示执行后需要重启系统使更改生效2.3 下载Ubuntu发行版访问微软官方文档获取手动下载链接 https://docs.microsoft.com/zh-cn/windows/wsl/install-manual推荐版本选择Ubuntu 20.04 LTS长期支持版稳定性最佳Ubuntu 22.04 LTS较新版本支持最新特性下载技巧复制下载链接到迅雷等下载工具可加速文件大小约200-500MB扩展名为.appx3. 手动安装Ubuntu到非系统盘3.1 准备安装目录选择目标磁盘如D盘创建安装目录D:\wsl\ubuntu-20.043.2 转换安装包格式将下载的.appx文件转换为可安装格式重命名文件后缀Ubuntu_2004.2021.825.0_x64.appx→Ubuntu_2004.zip解压到临时目录再次解压内部.appx文件到目标目录最终目录结构应包含ubuntu2004.exe install.tar.gz3.3 执行安装双击ubuntu2004.exe启动安装或使用命令行cd D:\wsl\ubuntu-20.04 .\ubuntu2004.exe安装过程将解压根文件系统创建虚拟硬盘镜像(ext4.vhdx)初始化用户账户需设置用户名和密码注意安装完成后该目录将包含完整的Linux系统文件请勿随意删除4. 高级配置与优化4.1 修改默认用户若需更改自动登录用户执行# 在WSL中执行 sudo nano /etc/wsl.conf添加以下内容[user] default 您的用户名保存后退出并重启WSLwsl --terminate Ubuntu-20.04 wsl -d Ubuntu-20.044.2 更换软件源提升软件下载速度替换为国内镜像源sudo sed -i s|http://archive.ubuntu.com|https://mirrors.aliyun.com|g /etc/apt/sources.list sudo apt update sudo apt upgrade -y其他可选镜像清华大学https://mirrors.tuna.tsinghua.edu.cn华为云https://repo.huaweicloud.com4.3 磁盘空间管理查看磁盘使用情况df -h清理APT缓存sudo apt clean sudo apt autoremove -y5. 多发行版管理与迁移5.1 列出已安装发行版wsl -l -v输出示例NAME STATE VERSION * Ubuntu-20.04 Running 2 Ubuntu-22.04 Stopped 15.2 导出备份发行版wsl --export Ubuntu-20.04 D:\wsl_backup\ubuntu20.04.tar5.3 导入已有发行版wsl --import Ubuntu-20.04-new D:\wsl\ubuntu-20.04-new D:\wsl_backup\ubuntu20.04.tar --version 2关键参数--version 2指定使用WSL2最后一个参数为备份文件路径5.4 设置默认发行版wsl --set-default Ubuntu-20.046. 常见问题解决方案6.1 安装失败0x80070003错误问题原因系统临时目录空间不足解决方案清理C:\Users\用户名\AppData\Local\Temp或设置环境变量TEMP和TMP指向其他磁盘6.2 WSL2网络访问异常修复命令wsl --shutdown netsh winsock reset6.3 文件系统性能优化对于大量IO操作的项目建议将项目文件放在Windows文件系统通过/mnt/访问或配置.wslconfig文件[wsl2] memory4GB processors4 localhostForwardingtrue保存到C:\Users\用户名\.wslconfig7. 生产力工具集成7.1 开发环境配置安装常用开发工具sudo apt install -y build-essential git python3-pip nodejs npm7.2 与Windows工具集成VS Code远程开发安装Remote - WSL扩展在WSL终端输入code .即可启动Docker Desktop集成安装Docker Desktop for Windows设置中启用Use the WSL 2 based engine7.3 图形界面支持安装GUI应用需X服务器如VcXsrvsudo apt install -y x11-apps export DISPLAY$(awk /nameserver / {print $2} /etc/resolv.conf):0测试运行xeyes