安装适用于 Linux 的 Windows 子系统（WSL）

一、检查 Windows 版本是否支持

WSL 要求特定的 Windows 版本，尤其是 WSL 2 需要较新的系统版本：

1、查看当前 Windows 版本

按下 Win + R，输入 winver 并回车，在弹出的窗口中查看系统版本：

Windows 11：所有版本均支持 WSL 2（无需额外条件）。

Windows 10：需满足以下版本：

家庭版 / 专业版 / 企业版：Build 19041 或更高（2020 年 5 月更新及之后版本）。

若版本低于 19041，需先通过 Windows 更新升级系统（设置 → 更新和安全 → Windows 更新）。

## 2、检查硬件是否支持虚拟化（WSL 2 必需）

WSL 2 依赖虚拟机平台（Virtual Machine Platform），需要 CPU 支持虚拟化技术并在 BIOS 中启用：

检查 CPU 是否支持虚拟化

英特尔（Intel）CPU：需支持 Intel VT-x 或 Intel VT-d。

AMD CPU：需支持 AMD-V 或 AMD-Vi。

几乎所有 2012 年后的 CPU 都支持，可通过 CPU 型号在官网查询具体参数）

检查虚拟化是否已启用以管理员身份打开 PowerShell，执行以下命令：

systeminfo | findstr /i "virtualization"

若显示 “虚拟化已启用”：说明已开启，满足 WSL 2 条件。

若显示 “虚拟化未启用”：需进入 BIOS 手动开启（步骤见下文）。

## 3、检查是否已启用必要的 Windows 功能

WSL 需要启用两个核心功能：“适用于 Linux 的 Windows 子系统” 和 “虚拟机平台”（WSL 2 必需）。

4、通过 PowerShell 检查功能状态

以管理员身份打开 PowerShell，执行：

# 检查“适用于 Linux 的 Windows 子系统”是否启用
Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

# 检查“虚拟机平台”是否启用（WSL 2 需要） Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform 若结果中 State 为 Enabled：说明功能已启用。 若 State 为 Disabled：需手动启用（后续安装步骤会涉及）。

4、确认系统架构（64 位必需）

WSL 仅支持 64 位系统，32 位系统无法安装。检查方法：

按下 Win + R，输入 msinfo32 并回车，查看 “系统类型”：

若显示 “x64-based PC”：支持 WSL。

若显示 “x86-based PC”：32 位系统，不支持 WSL。

##5、若虚拟化未启用，如何在 BIOS 中开启？

重启电脑，在开机时按对应按键进入 BIOS（不同品牌主板按键不同，常见为 Del、F2、F1、F10 等，开机时屏幕会提示）。

在 BIOS 中找到与虚拟化相关的选项（可能名为 Intel VT-x、AMD-V、Virtualization Technology 等），设置为 Enabled。

保存设置并重启电脑（通常按 F10 保存）。

二、彻底卸载旧版 WSL

注销所有 Linux 分发版以管理员身份打开 PowerShell，执行以下命令注销所有已安装的 Linux 分发版（例如 Ubuntu）：

wsl --list --verbose  # 查看所有分发版名称
wsl --unregister Ubuntu  # 替换为实际分发版名称

重复此步骤直到所有分发版都被注销。

禁用 WSL 功能在 控制面板 > 程序和功能 > 启用或关闭 Windows 功能 中，取消勾选 适用于 Linux 的 Windows 子系统，点击 确定 并重启电脑。

三、 删除残留文件

手动删除以下文件夹中的 WSL 相关文件（若存在）：

C:\Users\<用户名>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu*
C:\ProgramData\Microsoft\Windows\开始菜单\程序\适用于 Linux 的 Windows 子系统

(可选）清理注册表残留项（需谨慎操作）：

Remove-Item -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Wsl\Launchers"
Remove-Item -Path "HKLM:\Software\Microsoft\Windows\CurrentVersion\Wsl\Launchers"
警告：修改注册表有误可能导致系统问题，建议先备份注册表。

四、重新安装 WSL

启用必要功能以管理员身份打开 PowerShell，执行以下命令启用 WSL 和虚拟机平台功能：

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

重启电脑使更改生效。

更新 WSL 内核运行以下命令下载并安装最新的 WSL 内核更新包：

wsl --update

此步骤将自动更新 WSL 2 内核。

五、安装 Linux 分发版

方法 1：使用微软商店（推荐）打开 Microsoft Store，搜索并安装您选择的 Linux 分发版（如 Ubuntu 24.04 LTS）。安装完成后，首次启动时需设置用户名和密码。

方法 2：离线安装（适用于企业或无网络环境）从 WSL 官方发布页面 下载 .msixbundle 格式的安装包（如 Microsoft.WSL_2.2.4.0_x64_ARM64.msixbundle），双击运行即可自动安装。对于 Ubuntu，也可使用 tar 格式文件离线安装：

wsl --install --from-file ubuntu.tar.wsl  # 替换为实际文件路径

或直接双击 .wsl 文件完成安装。

设置默认 WSL 版本执行以下命令将默认版本设置为 WSL 2（推荐）：

wsl --set-default-version 2

验证版本：

wsl --list --verbose

确保所有分发版的 VERSION 列为 2。

三、初始化与配置

设置 root 用户密码（可选）

首次启动 Linux 分发版后，默认以普通用户登录。若需使用 root 权限，执行以下命令设置密码：

sudo passwd root  # 输入当前用户密码后设置 root 密码

切换到 root 用户：

su - root

更新系统

在 WSL 终端中执行以下命令更新软件包：

sudo apt update && sudo apt upgrade -y
sudo apt autoremove -y  # 清理不再需要的依赖

挂载 Windows 驱动器（可选）

WSL 默认将 Windows 驱动器挂载到 /mnt/ 目录（如 /mnt/c）。若需自定义挂载路径，可编辑 /etc/wsl.conf 文件：

sudo nano /etc/wsl.conf
添加以下内容：
ini 
automount root = /
options = "metadata"

保存后重启 WSL：

wsl --shutdown

四、故障排除

启动失败提示文件被占用执行以下命令强制关闭 WSL 服务并重启：

wsl --shutdown
taskkill /f /im vmcompute.exe  # 结束虚拟机相关进程（可选）

重启电脑后再次尝试启动。

服务无法启动检查 LxssManager 服务是否正常运行：

services.msc  # 打开服务管理器
# 确保 LxssManager 服务状态为“正在运行”，启动类型为“自动”

若服务异常，尝试手动重启或修复系统文件：

sfc /scannow  # 扫描并修复系统文件

安装时提示虚拟化未启用进入 BIOS 设置，启用 Intel VT-x 或 AMD-V 虚拟化技术（不同主板选项名称可能不同）。保存设置后重启电脑。

#五、高级操作（可选）

升级现有 WSL 1 到 WSL 2：

wsl --set-version Ubuntu 2  # 替换为实际分发版名称

备份与恢复 WSL 实例：

wsl --export Ubuntu backup.tar  # 导出分发版
wsl --unregister Ubuntu        # 注销原实例
wsl --import Ubuntu C:\wsl\Ubuntu backup.tar  # 恢复实例

通过以上步骤，您可以彻底卸载并重新安装 WSL，确保系统环境干净且功能正常。安装完成后，建议安装 Windows 终端 以获得更佳的多终端管理体验。