系统要求
- Windows 11 可以直接使用。
- Windows 10 需要 2004 及以上版本，内部版本建议在 19041 或更高。
- 如果系统太旧，建议先更新系统，再安装 WSL。
Windows Subsystem for Linux
Windows 安装 WSL 图文教程
这是一份可直接照着操作的快速版教程。按下面的 5 步做，通常 10 到 15 分钟左右就能在 Windows 上装好 WSL，并运行 Ubuntu、Debian 等 Linux 发行版。本文按必须使用 WSL 2 的标准来写。
适用系统：Windows 11 / Windows 10 2004+
必须版本：WSL 2
建议终端：PowerShell（管理员）
安装前先确认
先把最容易踩坑的两个前提确认掉，能省很多时间。
建议准备
- 控制面板里要开启“适用于 Linux 的 Windows 子系统”和“虚拟机平台”。
- 使用管理员权限打开 PowerShell。
- 电脑重启一次更稳妥。
- 如果后面提示虚拟化问题，去 BIOS 打开 Intel VT-x 或 AMD-V。
5 步安装流程
下面是带控制面板开启步骤的完整安装方式，最终目标是必须装成 WSL 2。
1
先在控制面板开启 WSL 相关功能
按 Win + R，输入 optionalfeatures 并回车，打开“启用或关闭 Windows 功能”。
- 勾选“适用于 Linux 的 Windows 子系统”。
- 勾选“虚拟机平台”。
- 点“确定”后等待系统处理，按提示重启电脑。
这一步做完，后面安装 WSL 2 会更稳。少了“虚拟机平台”，经常会导致只能跑成 WSL 1 或直接报错。
2
以管理员身份打开 PowerShell
开始菜单搜索 PowerShell，右键选择“以管理员身份运行”。如果你用的是 Windows Terminal，也可以右键后用管理员权限打开。
- 必须是管理员权限，否则启用系统组件可能失败。
- 看到窗口标题里带有“管理员”字样即可。
3
先把默认版本强制设为 WSL 2，再安装
在管理员 PowerShell 按顺序执行下面命令：
wsl --set-default-version 2 wsl --install -d Ubuntu
这样做的目的很明确：新安装的发行版默认就按 WSL 2 跑，不接受 WSL 1。
如果你想先看有哪些发行版可选，可以先执行：
wsl --list --online
如果你不想装 Ubuntu，也可以替换成别的发行版，例如：
wsl --install -d Debian
4
重启电脑并完成首次初始化
如果系统提示重启，直接重启。重启后，系统会自动打开刚安装的 Linux 发行版，首次启动会进行解压和初始化。
- 第一次打开时会稍微慢一点，这是正常现象。
- 初始化完成后，会提示你创建 Linux 用户名和密码。
- 这个用户名和密码是 Linux 环境里的，不是 Windows 登录密码。
5
验证是否安装成功，并确认版本就是 2
回到 PowerShell，执行下面命令查看结果：
wsl --status wsl -l -v
重点看 wsl -l -v 输出里的最右侧 VERSION 列。
- 如果看到
Ubuntu Running 2，说明你装的是 WSL 2，符合要求。 - 如果最右侧显示的是
1，说明当前还是 WSL 1，不算完成。 - 这时执行
wsl --set-version Ubuntu 2，把发行版转换成 WSL 2，再重新检查。
后续你可以直接输入 wsl 进入默认 Linux 环境，也可以在开始菜单里直接点开 Ubuntu。
常用命令备忘
装好之后，最常用的命令基本就这些。
安装和查看
wsl --set-default-version 2 wsl --list --online wsl --install -d Ubuntu wsl --set-version Ubuntu 2 wsl -l -v
维护和更新
wsl --status wsl --version wsl --update wsl --shutdown
常见问题
下面几个问题在新机器上最常见。
1. 输入 wsl --install 后只显示帮助，不安装
通常是系统版本较旧，或者当前环境不支持这一键安装。先执行 wsl --list --online 看是否有发行版列表，再尝试 wsl --install -d Ubuntu。
2. 安装卡在 0.0%
可以尝试使用联机下载方式：wsl --install --web-download -d Ubuntu。这类情况多见于商店组件拉取不顺畅。
3. 提示虚拟机平台或虚拟化不可用
先确认控制面板里已经勾选“虚拟机平台”，然后检查 BIOS 里是否开启了 Intel VT-x 或 AMD-V；两边都缺一不可。
4. wsl -l -v 里显示的是 1，不是 2
说明当前发行版还是 WSL 1。先执行 wsl --set-version Ubuntu 2，等转换完成后再执行 wsl -l -v，直到最右侧 VERSION 列变成 2。
安装后建议做的 3 件事
装完能用不代表配置就齐了，这三件事最实用。
执行 wsl --update，先把 WSL 组件更新到较新的版本，问题会少很多。
比传统控制台好用很多，标签页、分屏、字体和配色都更舒服。
以后直接在 WSL 里开发，文件、终端和插件环境会更顺手。