从 VHDX 文件恢复 (导入) WSL 2 安装
在注册表中重建相应的信息之后就能正常使用了.

Microsoft 官方以及常见的 WSL 导入导出方式, 都是通过 wsl --export 生成 tar 文件而使用 wsl --import 命令完成导入.

但是, 有时候出于某些意外, 比如系统出现严重问题需要重装, 或者其他导致注册表丢失的情况, Windows 丢失了 WSL 安装相关的信息, 将无法使用上述的方式进行导出.

不过, 只要还有 WSL 所在的 VHDX 文件 (虚拟磁盘文件), 就没有问题, 因为 WSL 最关键的就是这个虚拟磁盘文件, 只需要在注册表中重建相应的信息就能正常使用.

有时候 WSL 磁盘文件过大, 导入导出时容易出现问题, 这种方式也是适用的.

本文讲解的思路主要来自于 Issue #4762 - Microsoft/WSL.

注册表丢失的情况

笔者在重装系统之前, 是通过 Microsoft Store 安装的 Ubuntu 发行版. 应用商店中的数据一般在 %LocalAppData%/Packages 1 下.

重置系统 (选择保留个人数据) 后, 数据文件会被 迁移Windows.old 中, 也就是 X:/Windows.old/Users/%UserName%/AppData/Local/Packages 中.

其中, 商店里安装的 Ubuntu 发行版对应的包名会以 CanonicalGroupLimited.Ubuntu 开头, 打开对应的目录后, 在 LocalState 中就能找到 .vhdx 文件.

事实上, 重装系统后, 许多其他软件的数据也能从 Windows.old 中恢复. 为了防止 Windows.old 在一段时间后被清清除, 建议及时备份 Windows.old 中的用户文件.

可以将 .vhdx 文件剪切出来, 放在某个目录下, 比如 D:/wslinstall/ubuntu20.04.

之后, 根据下面的文件模板编写一个 REG 文件, 重建安装信息, 再导入注册表即能恢复 WSL 安装.

Windows Registry Editor Version 5.00

[HKEY_USERS\[SID]\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss\{[UUID]}]
"State"=dword:00000001
"DistributionName"="[DISTRO_NAME]"
"Version"=dword:00000002
"BasePath"="\\\\?\\[VHDX_PATH]"
"Flags"=dword:0000000f
"DefaultUid"=dword:000003e8

复制上述的模板到文本文件中, 并替换其中方括号标注的项 2:

替换说明
[SID] 3 打开 “命令提示符”, 使用 whoami /user 命令获取到自己 (当前用户) 的 SID
[UUID] 可以去这个 UUID 生成网站 随机生成一个 UUID
[DISTRO_NAME] 指定发行版的名称, 比如 Ubuntu
[VHDX_PATH] 发行版所在的路径, 并将反斜线转义, 比如 D:\\WSL\\Ubuntu

比如, 在上文中我们假设文件存储在了 D:/wslinstall/ubuntu20.04 目录下, 那么一个可用的 REG 文件就类似如下所示:

Windows Registry Editor Version 5.00

[HKEY_USERS\<你的 SID>\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss\{8ebf13b4-6ce3-4027-a2c7-f84ab4dad111}]
"State"=dword:00000001
"DistributionName"="Ubuntu 20.04"
"Version"=dword:00000002
"BasePath"="\\\\?\\D:\\wslinstall\\ubuntu20.04"
"Flags"=dword:0000000f
"DefaultUid"=dword:000003e8

将内容保存成后缀名为 reg 的文件, 比如一个名为 wsl-info.reg 的文件, 这样在 Windows 资源管理器中双击就可以完成导入.

导入完成后, 就可以在 Windows Termial 或者 wsl 命令中找到这个发行版了.

需要迁移 WSL 2 的情况

类似的, 只需要有 WSL 的 VHDX 文件, 重新建立注册表即可. 注意使用对应用户的 SID.

参考资料

关于 Windows 路径名缩写

WSL 安装和使用

参见 “使用 WSL 2 进行工作”.


  1. X:/Users/%UserName%/AppData/Local/Packages. 另见参考资料中 “关于 Windows 路径名缩写”. ↩︎

  2. 参考 @synergies 的评论回复↩︎

  3. 参考 Security identifiers - Microsoft Docs↩︎


Last modified on 2022-09-18