如何将已安装的WSL升级到WSL2？

Question

如何将已安装的WSL1升级到WSL2？升级后系统性能提升不明显，是否与内核版本或虚拟机平台未正确启用有关？在执行 `wsl --set-version` 命令时提示“无效参数”或“转换失败”，常见原因有哪些？是否需手动下载更新内核组件？此外，部分用户反映升级后无法启动发行版，提示“0x80370102”错误，这是否与BIOS中虚拟化未开启或Hyper-V配置冲突有关？如何通过 PowerShell 正确检查并完成 WSL 版本迁移？

Answer 1

一、WSL1 升级到 WSL2 的基础准备与检查

在进行 WSL 版本升级前，首先需确认系统环境支持 WSL2。WSL2 依赖于 Windows 的虚拟化架构，因此必须确保操作系统版本为 Windows 10 2004 或更高（Build 19041 及以上），或 Windows 11。

# 检查当前 Windows 内部版本号
winver

随后，在 PowerShell（管理员权限）中启用必要的可选功能：

• Virtual Machine Platform
• Windows Subsystem for Linux

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

执行完毕后建议重启系统以确保组件加载正确。

二、验证虚拟化支持与 BIOS 设置

若后续出现“0x80370102”错误，极有可能是 CPU 虚拟化未启用。可通过以下方式验证：

1. 打开任务管理器 → “性能”标签页 → 查看“虚拟化”是否已启用。
2. 若未启用，需进入 BIOS/UEFI 设置界面，开启 Intel VT-x 或 AMD-V 功能。

此外，Hyper-V 与第三方虚拟化软件（如 VMware、VirtualBox）可能存在兼容性问题。尽管 WSL2 不强制要求 Hyper-V 角色安装，但其底层仍使用相同的虚拟化平台。建议关闭冲突的第三方工具或通过如下命令检查状态：

Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All

输出中应显示“State : Enabled”或“Disabled”，根据需要手动启用。

三、设置默认 WSL 版本并执行升级操作

完成前置配置后，设置 WSL 默认版本为 2，避免新安装发行版仍使用 v1：

wsl --set-default-version 2

然后针对特定发行版执行版本升级：

wsl --list --verbose
wsl --set-version <DistroName> 2

错误码	可能原因	解决方案
Invalid argument	发行版名称拼写错误或未列出	使用 wsl --list 验证名称
Conversion failed	VM Platform 未启用或内核未更新	重新启用功能并更新内核
0x80370102	BIOS 虚拟化关闭或驱动冲突	开启 VT 并重置 WSL

四、手动更新 WSL 内核组件与疑难排查

即使完成了上述步骤，部分用户仍报告性能提升不显著。这通常与 WSL2 内核版本过旧有关。微软提供独立的内核更新包：

下载 WSL2 Linux 内核更新包

安装后可通过以下命令确认当前内核版本：

wsl --status

输出中将包含类似信息：
Kernel version: 5.15.90.1
建议保持该值为最新稳定版。

五、深度诊断流程图：WSL 升级失败分析路径

graph TD A[启动 WSL 升级] --> B{系统版本 >= 19041?} B -- 否 --> C[升级 Windows] B -- 是 --> D[启用 WSL 和 VM Platform] D --> E{重启后执行 wsl --set-version?} E -- 失败 --> F[检查虚拟化是否开启] F --> G{任务管理器显示虚拟化启用?} G -- 否 --> H[进入 BIOS 开启 VT-x/AMD-V] G -- 是 --> I[检查 Hyper-V 或第三方虚拟化冲突] I --> J[下载并安装 WSL2 内核更新] J --> K[再次尝试版本转换] K --> L[成功运行 WSL2]

六、高级调优建议与长期维护策略

对于 IT 从业者而言，WSL2 不仅是开发环境容器，更是 DevOps 流水线的一部分。建议通过 .wslconfig 文件优化资源分配：

# 用户目录下的 .wslconfig
[wsl2]
memory=8GB
processors=6
swap=4GB
localhostForwarding=true

此外，定期执行以下命令可维持系统健康：

• wsl --shutdown：彻底终止所有实例
• wsl --update：手动触发内核更新
• wsl --export / --import：备份与迁移发行版

当遇到顽固性启动问题时，可尝试重置 WSL：

dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux
# 重启后再重新启用