Skip to content

WSL 版本兼容性说明 ​

如果检测到你的 WSL 版本不在 WSL Dashboard 的适配范围内,程序会给出提示。在不适配的版本上运行,可能带来两个问题:

  • 存在数据安全风险:压缩、稀疏 VHD、克隆、导入导出等操作会直接读写虚拟磁盘,在不适配版本上可能导致数据损坏。
  • 部分功能可能无法正常使用:如 [boot]、[gpu]、[time] 等配置项在旧版本上不支持。

请先将 WSL 更新到适配版本,再使用完整功能。

一、查看当前版本 ​

以管理员身份打开 PowerShell,执行:

powershell
wsl --version

记下「WSL 版本」一行的数值。若该命令报错或没有这一行,说明是 Windows 内置的旧版 WSL,请直接按下面升级。

二、如何升级 ​

方式一:直接下载安装程序(推荐,升级更快更稳) ​

优先前往官方发布页:

https://github.com/microsoft/WSL/releases/latest

选择最新(或适配区间内)版本,下载 wsl.<版本>.x64.msi(ARM64 设备选 arm64),双击安装即可。

需 Windows 10 21H2 及以上,且已在「启用或关闭 Windows 功能」中开启「虚拟机平台」。

方式二:命令行更新 ​

以管理员身份在 PowerShell 中执行:

powershell
wsl --update

若 Store 不可用,可强制执行:

powershell
wsl --update --web-download

三、升级后 ​

powershell
wsl --shutdown
wsl --version

确认版本已落在适配区间后,完全退出并重启 WSL Dashboard,提示即会消失。

相关链接 ​