旧版 WSL 的手动安装步骤
步骤 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
低于 18362 的内部版本不支持 WSL 2。
若要检查 Windows 版本及内部版本号,请按 Windows 徽标键 + R,键入“winver”,然后选择“确定”。
步骤 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
。
- 下载最新的包:
arm计算机
如果使用 ARM64 计算机,请改为下载 ARM64 包。 如果不确定拥有哪种计算机,请打开命令提示符或 PowerShell 并输入:systeminfo | find "System Type"
。 注意事项: 非英语 Windows 版本中,可能需要修改搜索文本,翻译“系统类型”字符串。 你可能还需要对引号进行转义来用于 find 命令。 例如,在德语版中使用 systeminfo | find '"Systemtyp"'
。
- 运行在上一步中下载的更新包。 (双击以运行 - 系统会提示你输入提升的权限,选择“是”以批准此安装。
安装完成后,转到下一步 - 在安装新的 Linux 分发版时将 WSL 2 设置为默认版本。 (如果希望将新的 Linux 安装设置为 WSL 1,请跳过此步骤)。
步骤 5 - 将 WSL 2 设置为默认版本
打开 PowerShell 并运行以下命令,在安装新的 Linux 分发版时将 WSL 2 设置为默认版本:
PowerShell复制
wsl --set-default-version 2
步骤 6 - 安装所选 Linux 分发版
- 打开 Microsoft Store 并选择你喜欢的 Linux 分发版。中 Linux 分发版的视图以下链接将打开每个发行版的 Microsoft 商店页面:
- Ubuntu 18.04 LTS
- Ubuntu 20.04 LTS
- Ubuntu 22.04 LTS
- openSUSE Leap 15.1
- SUSE Linux Enterprise Server 12 SP5
- SUSE Linux Enterprise Server 15 SP1
- Kali Linux
- Debian GNU/Linux
- Fedora Remix for WSL
- Pengwin
- Pengwin Enterprise
- Alpine WSL
- 木筏(免费试用)
- Alma Linux
- 在分发页中,选择“获取”。中的 Linux 发行版
首次启动新安装的 Linux 分发版时,控制台窗口将打开,系统将要求你等待一到两分钟,以便文件取消压缩并存储在电脑上。 所有未来的发射应该需要不到一秒钟的时间。
然后,需要 为新的 Linux 分发版创建用户帐户和密码。
祝贺! 您已成功安装并设置了与 Windows 操作系统完全集成的 Linux 发行版!
排查安装问题
如果在安装过程中遇到问题,请查看故障排除指南 安装部分。
下载发行版
在某些情况下,你可能无法(或不想)使用 Microsoft 商店安装 WSL 的 Linux 发行版。 你可能正在运行不支持 Microsoft 应用商店的 Windows Server 或 Long-Term 服务 (LTSC) 桌面 OS SKU,或者公司网络策略和/或管理员不允许在环境中使用 Microsoft 应用商店。 在这些情况下,虽然 WSL 本身可用,但可能需要直接下载 Linux 分发版。
如果 Microsoft 应用商店应用不可用,则可以使用以下链接下载并手动安装 Linux 分发版:
- Ubuntu
- Ubuntu 24.04
- Ubuntu 22.04 LTS
- Ubuntu 20.04
- Ubuntu 20.04 ARM
- Ubuntu 18.04
- Ubuntu 18.04 ARM
- Ubuntu 16.04
- Debian GNU/Linux
- Kali Linux
- SUSE Linux Enterprise Server 12
- SUSE Linux Enterprise Server 15 SP2
- SUSE Linux Enterprise Server 15 SP3
- openSUSE Tumbleweed
- openSUSE Leap 15.3
- openSUSE Leap 15.2
- Oracle Linux 8.5
- Oracle Linux 7.9
- Fedora Remix for WSL
这将导致 <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
例如
Add-AppxPackage .\Ubuntu2404-240425.AppxBundle
Appx 包下载完成后,可以通过双击 appx 文件开始运行新分发版。 (在此步骤完成之前,命令 wsl -l
不会显示分发版已安装)。
如果使用 Windows Server,或者运行上述命令时遇到问题,可以在 Windows Server 文档页上找到备用安装说明,通过将其更改为 zip 文件来安装 .appx
文件。
安装分发版后,请按照说明 为新的 Linux 分发版创建用户帐户和密码。
安装 Windows 终端(可选)
使用 Windows 终端可以打开多个选项卡或窗口窗格,以便显示多个 Linux 分发版或其他命令行(PowerShell、命令提示符、Azure CLI 等)并快速切换。 可以使用独特的配色方案、字体样式、大小、背景图像和自定义键盘快捷方式完全自定义终端。 了解详细信息。