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

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

引用

CSDN

1.

https://blog.csdn.net/a2744739916/article/details/146464944

🌟什么是 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 ✅ 支持NVIDIACUDA
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>

将 替换为要安装的发行版的名称。

• 若要查看可通过在线商店下载的可用 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