通过

旧版 WSL 的手动安装步骤

  • 项目

为简单起见，我们通常建议使用 wsl --install 安装适用于 Linux 的 Windows 子系统，但如果运行的是较旧的 Windows 版本，则可能不受支持。 我们包括了下面的手动安装步骤。 如果在安装过程中遇到问题，请查看故障排除指南 安装部分。

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

必须先启用“适用于 Linux 的 Windows 子系统”可选功能，然后才能在 Windows 上安装任何 Linux 分发版。

以管理员身份打开 PowerShell （> PowerShell > 右键单击 > 以管理员身份运行） 并输入以下命令：

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

现在建议继续执行步骤 2，更新到 WSL 2，但如果只想安装 WSL 1，现在可以 重启 计算机，然后继续 步骤 6 - 安装所选 Linux 分发版。 若要更新到 WSL 2，等待重启 计算机，然后继续执行下一步。

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

若要更新到 WSL 2，必须运行 Windows 10...

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

或 Windows 11。

注意

低于 18362 的内部版本不支持 WSL 2。 使用 Windows 更新助手 更新 Windows 版本。 Windows 版本 1903 支持也仅适用于 x64 系统。 如果使用 Arm64 版本的 Windows，则需要升级到 Windows 10 版本 2004 或更高版本才能完全访问 WSL 2。 有关详细信息，请参阅 WSL 2 即将支持 Windows 10 版本 1903 和 1909。

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

注意

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

步骤 3 - 启用虚拟机功能

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

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

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

重启 计算机以完成 WSL 安装和更新到 WSL 2。

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

Linux 内核更新包安装最新版本的 WSL 2 Linux 内核，以便在 Windows 操作系统映像中运行 WSL。 要从 Microsoft Store 运行WSL，并使用更频繁发布的更新，请使用 wsl.exe --install 或 wsl.exe --update。

  1. 下载最新的包：

    注意

    如果使用 ARM64 计算机，请改为下载 ARM64 包。 如果不确定拥有哪种计算机，请打开命令提示符或 PowerShell 并输入：systeminfo | find "System Type"。 注意事项： 非英语 Windows 版本中，可能需要修改搜索文本，翻译“系统类型”字符串。 你可能还需要对引号进行转义来用于 find 命令。 例如，在德语版中使用 systeminfo | find '"Systemtyp"'。

  2. 运行在上一步中下载的更新包。 （双击以运行 - 系统会提示你输入提升的权限，选择“是”以批准此安装。

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

注意

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

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

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

wsl --set-default-version 2

步骤 6 - 安装所选 Linux 分发版

  1. 打开 Microsoft Store 并选择你喜欢的 Linux 分发版。

    Microsoft Store 中 Linux 分发版的视图

    以下链接将打开每个发行版的 Microsoft 商店页面：

  2. 在分发页中，选择“获取”。

    Microsoft 商店 中的 Linux 发行版

首次启动新安装的 Linux 分发版时，控制台窗口将打开，系统将要求你等待一到两分钟，以便文件取消压缩并存储在电脑上。 所有未来的发射应该需要不到一秒钟的时间。

然后，需要 为新的 Linux 分发版创建用户帐户和密码。

Ubuntu 在 Windows 控制台中解压缩

祝贺！ 您已成功安装并设置了与 Windows 操作系统完全集成的 Linux 发行版！

排查安装问题

如果在安装过程中遇到问题，请查看故障排除指南 安装部分。

下载发行版

在某些情况下，你可能无法（或不想）使用 Microsoft 商店安装 WSL 的 Linux 发行版。 你可能正在运行不支持 Microsoft 应用商店的 Windows Server 或 Long-Term 服务 （LTSC） 桌面 OS SKU，或者公司网络策略和/或管理员不允许在环境中使用 Microsoft 应用商店。 在这些情况下，虽然 WSL 本身可用，但可能需要直接下载 Linux 分发版。

如果 Microsoft 应用商店应用不可用，则可以使用以下链接下载并手动安装 Linux 分发版：

这将导致 <distro>.appx 包下载到所选文件夹。

如果愿意，还可以通过命令行下载首选分发版，可以将 PowerShell 与 Invoke-WebRequest cmdlet 配合使用。 例如，若要下载 Ubuntu 20.04，

Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing

提示

如果下载需要很长时间，请通过设置 $ProgressPreference = 'SilentlyContinue' 关闭进度栏

还可以选择使用 curl 命令行实用工具 进行下载。 使用 curl 下载 Ubuntu 20.04：

curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004

在此示例中，执行 curl.exe（而不仅仅是 curl），以确保在 PowerShell 中调用实际 curl 可执行文件，而不是 Invoke-WebRequest的 PowerShell curl 别名。

下载分发版后，导航到包含下载的文件夹，并在该目录中运行以下命令，其中 app-name 是 Linux 分发.appx文件的名称。

Add-AppxPackage .\app_name.appx

Appx 包下载完成后，可以通过双击 appx 文件开始运行新分发版。 （在此步骤完成之前，命令 wsl -l 不会显示分发版已安装）。

如果使用 Windows Server，或者运行上述命令时遇到问题，可以在 Windows Server 文档页上找到备用安装说明，通过将其更改为 zip 文件来安装 .appx 文件。

安装分发版后，请按照说明 为新的 Linux 分发版创建用户帐户和密码。

安装 Windows 终端（可选）

使用 Windows 终端可以打开多个选项卡或窗口窗格，以便显示多个 Linux 分发版或其他命令行（PowerShell、命令提示符、Azure CLI 等）并快速切换。 可以使用独特的配色方案、字体样式、大小、背景图像和自定义键盘快捷方式完全自定义终端。 了解详细信息。

安装 Windows 终端。

Windows 终端