# WSL2安装与配置

推荐个跨平台markdown编辑器 https://www.typora.io/

在 Windows 10 上创建开发环境 | Microsoft Docs (opens new window)

微软WSL官方文档 https://docs.microsoft.com/zh-cn/windows/wsl/

# 步骤 1 - 启用适用于 Linux 的 Windows 子系统

以管理员身份打开 PowerShell 并运行：

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

# 步骤 2 - 检查运行 WSL 2 的要求

若要更新到 WSL 2，需要运行 Windows 10。

对于 x64 系统：版本 1903 或更高版本，采用 内部版本 18362 或更高版本。
对于 ARM64 系统：版本 2004 或更高版本，采用 内部版本 19041 或更高版本。
低于 18362 的版本不支持 WSL 2。使用 Windows Update 助手 (opens new window)更新 Windows 版本。

若要检查 Windows 版本及内部版本号，选择 Windows 徽标键 + R，然后键入“winver”，选择“确定”。更新到“设置”菜单中的最新 Windows 版本。

备注

如果运行的是 Windows 10 版本1903 或 1909，请在 Windows 菜单中打开“设置”，导航到“更新和安全性”，然后选择“检查更新”。内部版本号必须是 18362.1049+ 或 18363.1049+，次要内部版本号需要高于 .1049。阅读详细信息：WSL 2 即将支持 Windows 10 版本 1903 和 1909 (opens new window)。请参阅疑难解答说明 (opens new window)。

# 步骤 3 - 启用虚拟机功能

以管理员身份打开 PowerShell 并运行：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 步骤 4 - 下载 Linux 内核更新包

下载最新包：
- 适用于 x64 计算机的 WSL2 Linux 内核更新包 (opens new window)
备注

如果使用的是 ARM64 计算机，请下载 ARM64 包 (opens new window)。如果不确定自己计算机的类型，请打开命令提示符或 PowerShell，并输入：systeminfo | find "System Type"。 警告： 在非英语 Windows 版本中，你可能需要修改搜索文本，例如在德语中为 systeminfo | find "Systemtyp"。
运行上一步中下载的更新包。（双击以运行 - 系统将提示你提供提升的权限，选择“是”以批准此安装。）

安装完成后，请继续执行下一步 - 在安装新的 Linux 分发时，将 WSL 2 设置为默认版本。（如果希望将新的 Linux 安装设置为 WSL 1，请跳过此步骤。）

备注

有关详细信息，请参阅 Windows 命令行博客 (opens new window)上的文章对更新 WSL2 Linux 内核的更改 (opens new window)。

# 步骤 5 - 将 WSL 2 设置为默认版本

打开 PowerShell，然后在安装新的 Linux 发行版时运行以下命令，将 WSL 2 设置为默认版本：

wsl --set-default-version 2

# 步骤 6 - 安装所选的 Linux 分发

# 安装 Windows 终端（可选）

# 将分发版版本设置为 WSL 1 或 WSL 2

可打开 PowerShell 命令行并输入以下命令（仅在 Windows 内部版本 18362 或更高版本中可用），检查分配给每个已安装的 Linux 分发版的 WSL 版本：wsl -l -v

wsl --list --verbose

若要将分发版设置为受某一 WSL 版本支持，请运行：

wsl --set-version <distribution name> <versionNumber>

请确保将 <distribution name> 替换为你的分发版的实际名称，并将 <versionNumber> 替换为数字“1”或“2”。可以随时更改回 WSL 1，方法是运行与上面相同的命令，但将“2”替换为“1”。

备注

从 WSL 1 更新到 WSL 2 可能需要几分钟才能完成，具体取决于目标分发版的大小。如果从 Windows 10 周年更新或创意者更新运行 WSL 1 的旧（历史）安装，可能会遇到更新错误。按照这些说明卸载并删除任何旧分发 (opens new window)。

如果 wsl --set-default-version 结果为无效命令，请输入 wsl --help。如果 --set-default-version 未列出，则表示你的 OS 不支持它，你需要更新到版本 1903（内部版本 18362）或更高版本。如果你在使用 ARM64 版本 19041，那么当使用 PowerShell 时，此命令可能会失败；在这种情况下，你可使用命令提示符，而不是发出 wsl.exe 命令。

运行命令后如果看到此消息：WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel。仍需要安装 MSI Linux 内核更新包。

此外，如果要使 WSL 2 成为你的默认体系结构，可以通过此命令执行该操作：

wsl --set-default-version 2

这会将安装的任何新分发版的版本设置为 WSL 2。

← 框架介绍 vscode安装与配置 →