Windows 安装 WSL2 全指南（2025 版）

一、什么是 WSL2？

WSL，全称 Windows Subsystem for Linux，是微软提供的一项功能，让用户可以在 Windows 上直接运行 Linux 系统。
而 WSL2 则是其第二代版本，底层采用轻量虚拟机技术，性能更高、兼容性更好。

主要优势包括：

• 原生运行 Linux 内核；
• 支持 Docker、systemd、GPU 加速；
• 文件系统访问速度显著提升；
• 无需双系统，即可同时使用 Windows 与 Linux 工具链。

---

二、系统要求

• Windows 10 2004 及以上版本（内核版本 ≥ 19041）
• 或 Windows 11 任意版本
• 需要管理员权限运行 PowerShell

👉 想了解你的系统是否支持？查看官方要求：微软官方文档：https://learn.microsoft.com/zh-cn/windows/wsl/install

---

三、一键安装 WSL2（推荐方式）

在 PowerShell（管理员模式） 中执行以下命令：

wsl --install

该命令将自动完成以下任务：

1. 启用 WSL 与虚拟机功能；
2. 下载并安装最新的 Linux 内核；
3. 默认安装 Ubuntu；
4. 自动设置为 WSL2 模式。

安装完成后，系统会提示重启。
重启后，你可以通过以下命令确认安装状态：

wsl -l -v

输出类似：

  NAME      STATE           VERSION
* Ubuntu    Running         2

✅ 提示：若版本为 1，可执行以下命令升级：

wsl --set-version Ubuntu 2

---

四、手动安装步骤（适用于特殊情况）

若自动安装失败，可按以下顺序手动执行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2

然后前往 Microsoft Store 搜索并安装你喜欢的 Linux 发行版，例如：

• Ubuntu
• Debian
• Kali Linux
• openSUSE

下载完成后，点击启动，设置用户名与密码即可。

---

五、Docker 与 WSL2 配合

WSL2 与 Docker Desktop 无缝集成。
安装最新版 Docker Desktop：https://www.docker.com/products/docker-desktop后，在设置中启用：

⚙️ Settings → General → Use the WSL 2 based engine

完成后，即可在 WSL2 内直接运行 Docker 命令：

docker run hello-world

若输出 “Hello from Docker!”，说明安装成功。

---

六、常见问题与解决方案

问题	解决方案
启动时报错 “Please enable the Virtual Machine Platform”	以管理员身份运行 PowerShell，执行：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
无法联网	检查防火墙或 VPN 设置，重启 WSL：wsl --shutdown
升级 WSL 版本失败	确认系统版本 ≥ 19041，或运行 wsl --update

---

七、总结

WSL2 的出现，使得开发者在 Windows 上拥有了接近原生 Linux 的体验。
无论是编译、运行服务器环境，还是使用 Docker、Git、Python 等工具，WSL2 都能提供极高的兼容性与性能。

📘 更多信息可参考：

• 微软官方文档：https://learn.microsoft.com/zh-cn/windows/wsl/
• Docker 官方教程：https://docs.docker.com/desktop/windows/wsl/

---

🧭 推荐阅读

• Windows 上安装 Docker 最佳实践
• WSL2 网络配置详解
• 使用 VS Code 连接 WSL 开发环境