WSL 2安装与配置实战：从开启功能到多发行版管理

微软专家

Windows Subsystem for Linux (WSL) 是微软提供的官方方案，允许在 Windows 上直接运行 Linux 环境，无需虚拟机或双系统。WSL 2 基于虚拟化技术，性能更接近原生 Linux，支持完整的系统调用，适合开发、测试和日常使用。本文基于实际部署经验，梳理从系统检查、安装配置到迁移优化的完整流程，并提供常见报错的解决路径。

一、安装前的环境确认
确保 Windows 版本满足要求：Windows 10 1903 (内部版本 18362) 及以上，或 Windows 11。在运行窗口输入 winver 可查看版本号。另外需要确认 CPU 支持虚拟化：在命令提示符 (CMD) 中执行 systeminfo，查看“Hyper-V要求”项是否为“是”。

关于 WSL 版本的选择：WSL 1 与 Windows 文件系统互操作性好，但系统调用性能较弱；WSL 2 使用轻量级虚拟机，性能更强且支持 Docker 原生运行，推荐优先选用 WSL 2。

二、安装步骤详解
1. 启用 Windows 功能
通过控制面板的“启用或关闭 Windows 功能”勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”，然后重启。也可用管理员 PowerShell 执行以下命令快速开启：

2. dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
3. dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

复制代码

执行后务必重启系统。

2. 升级 WSL 2 内核
下载 WSL 2 Linux 内核更新包 wsl_update_x64.msi 并安装。安装完成后，在 PowerShell 中设置 WSL 2 为默认版本：

2. wsl --set-default-version 2

复制代码

3. 安装 Linux 发行版
最简单的方式是通过 Microsoft Store 搜索并安装 Ubuntu 或 Debian 等发行版，启动后按提示设置用户名和密码（注意用户名只能使用小写字母）。
若想自定义安装路径（例如 D 盘），可通过命令行手动部署。以 Ubuntu 20.04 为例，在 PowerShell 中执行：

2. cd D:\
3. Invoke-WebRequest -Uri https://wsldownload.azureedge.net/Ubuntu_2004.2020.424.0_x64.appx -OutFile Ubuntu20.04.appx
4. Rename-Item .\Ubuntu20.04.appx Ubuntu.zip
5. Expand-Archive .\Ubuntu.zip -Verbose
6. cd .\Ubuntu\
7. .\ubuntu2004.exe

复制代码

安装程序会引导创建用户，之后的子系统文件生成在 D 盘指定目录。

4. 更换软件源加速
进入 Linux 子系统后，先备份原源列表：

2. sudo cp /etc/apt/sources.list /etc/apt/sources.list_backup

复制代码

然后替换为中科大等国内镜像源：

2. sudo sed -i 's/archive.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list

复制代码

最后更新软件包：

2. sudo apt update && sudo apt upgrade

复制代码

三、常见问题及解决办法
1. 报错 0x800701bc：未安装 WSL 2 内核更新包，请完成上文“升级 WSL 2 内核”步骤。
2. C 盘空间不足：使用 wsl --export 和 wsl --import 命令将子系统迁移到其他磁盘。例如：

2. wsl --export Ubuntu D:\ubuntu.tar
3. wsl --unregister Ubuntu
4. wsl --import Ubuntu D:\wsl\Ubuntu D:\ubuntu.tar

复制代码

3. 网络下载失败：可尝试在 hosts 文件中添加 199.232.68.133 raw.githubusercontent.com 解决 DNS 污染。
4. 需要图形界面：在 WSL 中安装 Xfce4 桌面，并在 Windows 上运行 VcXsrv X 服务器即可实现 GUI。

四、高效开发配置
Visual Studio Code 通过安装 Remote - WSL 插件，可直接在 Windows 编辑器中编写和调试 Linux 子系统中的代码，无需切换环境。
WSL 2 原生支持 Docker 的 WSL 2 backend，在子系统内安装 Docker 即可获得与 Linux 几乎一致的容器体验。
管理多发行版：使用 wsl --list 查看已安装的子系统，wsl -d <发行版名> 切换运行。

五、扩展工具
Windows Terminal 是微软推出的高颜值终端，支持多标签、自定义主题，能同时管理多个 WSL 实例和 PowerShell、CMD 等。
LxRunOffline 是第三方管理工具，支持备份、恢复和迁移 WSL 子系统。

WSL 的文件系统可通过 \\wsl$ 在 Windows 资源管理器中直接访问，方便双向编辑。
掌握以上配置，即可在 Windows 上获得接近原生的 Linux 开发体验，同时保留 Windows 的桌面生态优势。

热心网友4

感谢楼主分享这么详细的WSL 2安装配置指南！步骤清晰，从环境检查到常见报错都有覆盖，对新手特别友好。有个小问题想请教：我按流程迁移子系统到D盘后，wsl --import成功，但启动时提示“用户目录未找到”，需要重新创建用户吗？还是有什么方法能保留原用户配置？谢谢！