【全流程】从零开始在 Windows 上安装 WSL2

🌟什么是 WSL？

WSL（Windows Subsystem for Linux）是微软推出的兼容层，允许用户在 Windows 上直接运行 Linux 环境。它无需传统虚拟机或双系统，即可无缝使用 Linux 命令行工具和应用程序。它实现了：

• 零开销运行：无需传统虚拟机即可执行原生 Linux ELF 二进制文件
• 系统调用转换：实时转换 Linux 系统调用为 Windows NT API
• 混合文件系统：通过 9P 协议 实现跨系统文件访问

WSL2 是当前的最新版本。

🚀为什么要安装 WSL2？

场景	✅解决方案
跨平台开发	直接运行 Linux 工具链（如 GCC、Python）
环境一致性	避免“在我机器上能运行，在你机子上无法运行” 的问题
资源高效利用	内存占用仅为虚拟机的 1/10
AI/大数据开发	原生支持 TensorFlow/PyTorch 等框架，新兴的算法基本都支持 Linux

• 开发便利性：直接在 Windows 上运行 Linux 工具 （一些新兴的算法和模型可能目前只支持 Linux 环境）

• 跨平台兼容：解决开发环境因系统差异导致的问题。

• 资源高效：相比虚拟机，WSL 占用 更少内存和 CPU 资源。

🔥WSL2 的优势

• 拥有完整的 Linux 内核：基于 Hyper-V 虚拟化技术，提供更完整的系统调用兼容性。

• 文件系统性能提升：文件读写速度显著优于 WSL1，可 直接访问 Windows 文件（/mnt/c/），相当方便！

• 支持 Docker 等工具：可直接在 WSL2 中运行容器化应用，支持 Docker Desktop、GPU 加速 等高级功能。

特性	WSL1	WSL2
架构	转换层模拟系统调用	完整 Linux 内核
启动速度	更快（秒级）	首次较慢（约2-5秒）
文件 I/O 性能	Windows 目录慢	本地 Linux 文件快，接近原生
GPU 支持	❌不支持 CUDA	✅ 支持 NVIDIA CUDA
Docker 兼容性	需 Docker Desktop	✅原生支持 Docker

---

1. 🔍系统要求

• 操作系统要求 Windows 10 2004+（Build 19041+) 或 Windows 11

💡 如何检查Windows版本：

按下 Win + R，输入 winver，确认版本号 ≥ 19041。

• 硬件要求：
  • 64位 CPU（支持虚拟化）
  • 至少 4GB 内存（推荐 8GB+ ）
• 以 管理员身份 操作 PowerShell

---

2. 🌟 启用虚拟化（如未开启）

步骤一： 打开任务管理器 （Ctrl+Shift+Esc）→ 性能选项卡 → 查看“虚拟化”是否启用。

步骤二： 若显示 未启用：在开始菜单搜索启用或关闭 Windows 功能，点击打开对话窗口如下，然后找到 适用于 Linux的Windows子系统，虚拟机平台，并勾选，然后点击确定。重启 Windows 系统

---

3. 🛠️安装 WSL2 和 Ubuntu

3.1 方法一：自动安装（推荐）

步骤一： 在 管理员模式 下打开 PowerShell 或 Windows 命令提示符，

wsl --install

此命令将启用运行 WSL 并安装 Linux 的 Ubuntu 发行版所需的功能

步骤二： 自定义安装选项（PowerShell）

默认情况下，安装的 Linux 分发版为 Ubuntu。 可以使用 -d 标志进行更改。

• 若要更改安装的发行版

  wsl --install -d <Distribution Name>
  

  将 <Distribution Name> 替换为要安装的发行版的名称。

• 若要查看可通过在线商店下载的可用 Linux 发行版列表，输入：wsl --list --online 或 wsl -l -o

• 若要 在初始安装后安装 其他 Linux 发行版，还可使用命令：wsl --install -d <Distribution Name>

# 列出可用发行版
wsl --list --online
# 示例：安装 Ubuntu 22.04 LTS
wsl --install -d Ubuntu-22.04
# 设置默认 WSL 版本
wsl --set-default-version 2   # 直接升级到 wsl2

若键入 wsl --install -d Ubuntu-22.04 出现：❌

无法从“https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json”中提取列表分发。无法解析服务器的名称或地址
错误代码: Wsl/WININET_E_NAME_NOT_RESOLVED

此为网络问题，我们采用 手动安装 Linux 发行版方法，直接从 Microsoft Store 下载 Ubuntu 22.04 安装即可（见下文）

步骤三：设置账户信息

安装 WSL2 后，需要为新安装的 Linux 发行版创建用户 帐户和密码

3.2 方法二：手动安装 （旧版系统适用）

步骤一：启用适用于 Linux 的 Windows 子系统

需要先启用“适用于 Linux 的 Windows 子系统”可选功能，然后才能在 Windows 上安装 Linux （见上文）

1. 安装 WSL2 之前，必须启用 虚拟机平台 可选功能。 计算机需要虚拟化功能才能使用此功能。

以 管理员身份 打开 PowerShell，输入：

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

2. 重新启动计算机

步骤二：安装 WSL2 内核更新包

1. 若要更新到 WSL2，需要运行 Windows 10 或 Windows 11

• 对于 x64 系统：版本 1903 或更高版本，内部版本为 18362.1049 或更高版本。

• 对于 ARM64 系统：版本 2004 或更高版本，内部版本为 19041 或更高版本。

⚠️ WSL2 版本兼容性提示：

低于 18362 的版本不支持 WSL2。使用 Windows Update 助手 更新 Windows 版本。 Windows 版本 1903 支持仅适用于 x64 系统。 若使用 Arm64 版 Windows，需升级至 Windows 10 版本 2004 或更高。

若要检查 Windows 版本及内部版本号，选择 win + R，然后键入 winver ，选择“确定”。

⚠️ WSL2 即将支持 Windows 10 版本 1903 和 1909

如果运行的是 Windows 10 版本 1903 或 1909，请在 Windows 菜单中打开“设置”，导航到“更新和安全性”，然后选择“检查更新”。 内部版本号必须是 18362.1049+ 或 18363.1049+，次要内部版本号需要高于 .1049

2. 下载并安装：WSL2 Linux 内核更新包，以便在 Windows 操作系统映像中运行 WSL2

3. 重新启动计算机

步骤三：设置 WSL2 为当前默认版本

wsl --set-default-version 2

步骤四：安装 Ubuntu 20.04.6 LTS（这个版本很好）

1. 打开 Microsoft Store，搜索 Ubuntu 20.04 LTS 并安装

如果 Microsoft Store 应用无法下载，可点击以下链接来下载并手动安装：

🐧 Ubuntu 发行版

Ubuntu 24.04 LTS | Ubuntu 22.04 LTS | Ubuntu 20.04 LTS (x64) | Ubuntu 20.04 LTS (ARM)

🦎 SUSE 发行版

SUSE Linux Enterprise Server 12 | SUSE Linux Enterprise 15 SP2 | SUSE Linux Enterprise 15 SP3

📦 openSUSE

Tumbleweed | Leap 15.3

🐃 Oracle Linux

Oracle Linux 8.5 | Oracle Linux 7.9

2. 使用 PowerShell 直接安装：（一般会存在网络问题，无法下载，不建议❌）

wsl --install -d Ubuntu-20.04

步骤五：初始化 Ubuntu

1. 在 开始菜单 中打开 Ubuntu

2. 等待安装完成，按提示输入用户名和密码（密码输入时字符不可见，正常输入后回车，Linux特色）

---

4. ✅验证安装

步骤一：检查 WSL 版本

wsl -l -v

确认 Ubuntu 20.04 的版本为 2

(base) PS C:\Users\Weiyuantong> wsl -l -v
  NAME            STATE           VERSION
* Ubuntu-20.04    Running         2 

亦或直接在 PowerShell 里输入：wsl，输出 Welcome...，则安装成功

步骤二：升级 Ubuntu 软件包

sudo apt update && sudo apt upgrade -y

---

5. 🚀 进阶配置与使用技巧

5.1 文件系统交互

自由访问 Windows 文件：WSL2 中可通过 /mnt/c/ 直接访问 C 盘，/mnt/d/ 访问 D 盘等本地盘

优化性能：避免在 Windows 路径下操作 Linux 文件（如 /mnt/c/），建议将项目文件放在 Linux 子系统中（如 ~/projects），文件传输效率更高

# 快速进入 Windows 用户目录
cd /mnt/c/Users/YourUserName/

这是安装 Ubuntu-20.04 系统后，在 Windows 本地的 Linux 系统

5.2 配置 GPU 加速支持

若需在 WSL2 中使用 NVIDIA GPU（如运行 CUDA 任务，跑深度学习项目等）：

可以在 WSL2 中安装 CUDA Toolkit，配置 NVIDIA GPU 驱动

wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-wsl-ubuntu.pin
sudo mv cuda-wsl-ubuntu.pin /etc/apt/preferences.d/cuda-repository-pin-600
sudo apt-key adv --fetch-keys https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/7fa2af80.pub
sudo apt-get update
sudo apt-get -y install cuda

5.3 解锁资源限制

扩充 WSL2 内存和 CPU 使用限制：

在 C:\Users\<用户名>\.wslconfig 中配置（若文件不存在需新建）：

[wsl2]
memory=4GB   # 限制最大内存为4GB
processors=4 # 使用4个CPU核心

---

​ 🔥 立即开启你的Linux+Windows融合开发之旅吧！🔥

📚 参考资料

微软官方 WSL 文档| Microsoft Learn

有想交流的朋友可以私信我，或关注微信公众号：咚叶的小铺
欢迎大家一起交流！

📝 文档声明
所有功能均通过实际场景验证，转载请注明出处：[https://blog.csdn.net/a2744739916/article/details/146464944]

🎂 特别通告🎂

🎉 今天吃小蛋糕~ | 🚀 愿读者们天天开心 | 💪 愿我一战上岸！