Windows 安装 WSL 图文教程

安装前先确认

先把最容易踩坑的两个前提确认掉，能省很多时间。

先看这一段

系统要求

Windows 11 可以直接使用。
Windows 10 需要 2004 及以上版本，内部版本建议在 19041 或更高。
如果系统太旧，建议先更新系统，再安装 WSL。

建议准备

控制面板里要开启“适用于 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

执行安装命令，会自动完成重启和初始化

在管理员 PowerShell 执行下面命令：

wsl --install -d Ubuntu

新版 Windows（Win10 22H2+ 和 Win11）会一次性完成所有步骤：

自动下载并安装 WSL 2 和 Ubuntu
如果需要重启，会提示你重启
重启后自动打开 Ubuntu，首次启动会自动进行解压和初始化
初始化完成后，直接提示你创建 Linux 用户名和密码

整个过程不需要你手动执行两步，命令跑完等着就行。

第一次打开时会稍微慢一点，这是正常现象。
初始化完成后，会提示你创建 Linux 用户名和密码。
这个用户名和密码是 Linux 环境里的，不是 Windows 登录密码。
输入密码时，窗口不会显示字符或星号，这是正常的；输完回车后再重复输入一次即可。

4

更新 WSL、验证版本、设置密码

回到 PowerShell，按顺序执行下面命令：

wsl --update
wsl -l -v

wsl --update 会把 WSL 组件更新到最新版本，建议先执行这个，问题会少很多。

重点看 wsl -l -v 输出里的最右侧 VERSION 列。

如果看到 Ubuntu Running 2，说明你装的是 WSL 2，符合要求。
如果最右侧显示的是 1，说明当前还是 WSL 1，不算完成。
这时执行 wsl --set-version Ubuntu 2，把发行版转换成 WSL 2，再重新检查。

如果还需要改密码，进入 WSL 后执行 passwd。

后续你可以直接输入 wsl 进入默认 Linux 环境，也可以在开始菜单里直接点�� Ubuntu；能正常进入类似 your_name@DESKTOP:~$ 的提示符，也说明安装和启动都已经打通。

5

换文件位置或改名字

如果你不想把发行版放在系统盘，或者想改成别的名字，分三种情况处理。

还没安装时，最省事的做法是直接指定位置：wsl --install -d Ubuntu --location D:\WSL\Ubuntu。
已经装好了，不要直接去资源管理器里手动剪切 WSL 文件夹。

情况一：只需要改名字，不换位置

如果只是想换个名字（比如改成 Ubuntu-22.04 或 MyLinux），用导出导入可以保留原位置的文件：

wsl --shutdown
wsl --export Ubuntu D:\WSL\ubuntu.tar
wsl --unregister Ubuntu
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu D:\WSL\ubuntu.tar --version 2

新名字写在 --import 后面的第一个参数位置。
第三个参数 D:\WSL\Ubuntu 保持不变，这样文件还会留在原位置。
wsl -l -v 确认名字已经改成 Ubuntu-22.04。

情况二：换位置（同时也想改名字）

如果既要换位置也想改名字，导出的路径和导入的路径分开指定：

wsl --shutdown
wsl --export Ubuntu D:\WSL\backup\ubuntu.tar
wsl --unregister Ubuntu
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu-22.04 D:\WSL\backup\ubuntu.tar --version 2

导出文件放在 D:\WSL\backup\ 备份文件夹。
导入到 D:\WSL\Ubuntu-22.04\ 新位置。
新位置不需要预先创建目录。

情况三：不改名字，只换位置

如果只是想换个位置但保留原名字，参考情况二的命令，只需要把新名字改成和原来一样：

wsl --shutdown
wsl --export Ubuntu D:\WSL\backup\ubuntu.tar
wsl --unregister Ubuntu
wsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\backup\ubuntu.tar --version 2

无论哪种情况，wsl --unregister 会删除原发行版，所以一定要先确认导出文件已经生成成功。如果不确定，用 wsl -l -v 先确认发行版名字。

常用命令备忘

装好之后，最常用的命令基本就这些。

建议收藏

安装和查看

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

装好后第一次怎么用

下面两件事是新手装完 WSL 之后最常问的。

上手速查

1. 怎么确认安装成功

在 PowerShell 里执行下面两条命令：

wsl --status
wsl -l -v

看到发行版名称，例如 Ubuntu，说明系统已经识别到你的 WSL 发行版。
wsl -l -v 最右侧 VERSION 必须是 2，这才算装成了 WSL 2。
继续执行 wsl，如果能进入类似 your_name@DESKTOP:~$ 的提示符，也说明已经能正常启动。

2. 怎么启动 WSL

最常用的启动方式有三种，任选一种都可以。

开始菜单直接搜索并打开 Ubuntu，这是最直观的入口。
在 Windows Terminal 里选择 Ubuntu 配置文件打开。
在 PowerShell 或 CMD 里输入 wsl 进入默认发行版；如果想指定发行版，用 wsl -d Ubuntu。

常见问题

下面几个问题在新机器上最常见。

排错速查

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。

5. 想装别的发行版怎么办

先执行 wsl --list --online 查看有哪些发行版可选，然后执行 wsl --install -d Debian（或其他发行版名称）安装。

安装后建议做的 3 件事

装完能用不代表配置就齐了，这三件事最实用。

进阶建议

更新 WSL

执行 wsl --update，先把 WSL 组件更新到较新的版本，问题会少很多。

装 Windows Terminal

比传统控制台好用很多，标签页、分屏、字体和配色都更舒服。

配 VS Code Remote - WSL

以后直接在 WSL 里开发，文件、终端和插件环境会更顺手。