当注册表丢失后：手动重建 WSL 2 的 VHDX 安装记录

1. 当WSL 2注册表丢失时会发生什么

最近我在迁移开发环境时遇到了一个棘手的问题：重装系统后，原本好好的WSL 2 Ubuntu突然无法识别了。经过排查发现，原来是Windows注册表中WSL的相关配置信息丢失了。这种情况其实很常见，比如系统崩溃、重装系统或者注册表清理过度，都可能导致WSL的注册表项丢失。

WSL 2与一代最大的区别在于它使用了真正的虚拟机技术，每个发行版都是一个独立的VHDX虚拟磁盘文件。这个文件包含了完整的Linux文件系统和所有数据，相当于一个完整的Linux系统。但Windows需要通过注册表知道这些VHDX文件的存在和位置信息。

注册表丢失后，虽然wsl命令会提示"找不到发行版"，但你的Linux数据其实完好无损地保存在VHDX文件中。我当时的Ubuntu系统里有好几个重要的开发项目，如果按照常规方法重新安装，这些数据就都没了。好在通过手动重建注册表项，我成功找回了完整的开发环境。

2. 找回VHDX文件的完整指南

2.1 定位VHDX文件的位置

首先需要找到你的WSL虚拟磁盘文件。根据安装方式不同，VHDX文件可能存放在以下几个位置：

• 通过Microsoft Store安装的发行版：通常在%LocalAppData%\Packages\<发行版包名>\LocalState目录下
• 手动导入的发行版：一般在用户指定的目录中，比如C:\WSL\Ubuntu
• 系统重置后：可能在Windows.old文件夹中保留着原系统的文件

以我自己的Ubuntu 20.04为例，包名是CanonicalGroupLimited.Ubuntu20.04onWindows，完整路径就是：

code复制C:\Users\<用户名>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu20.04onWindows\LocalState\ext4.vhdx

2.2 备份VHDX文件

找到VHDX文件后，强烈建议先做个备份。我习惯把它复制到一个安全的目录，比如：

bash复制mkdir D:\WSL_Backups
copy C:\Users\<用户名>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu20.04onWindows\LocalState\ext4.vhdx D:\WSL_Backups\ubuntu_backup.vhdx

如果文件很大，复制可能需要一些时间。我曾经有个50GB的WSL镜像，复制花了将近20分钟。耐心等待，这个等待是值得的。

3. 手动重建注册表项

3.1 获取必要的系统信息

重建注册表需要几个关键信息：

1. 用户SID：打开命令提示符，运行：

   cmd复制whoami /user
   

   你会看到类似S-1-5-21-3623811015-3361044348-30300820-1013的字符串，这就是你的用户SID。

2. 生成UUID：每个WSL实例都需要一个唯一标识符。你可以使用在线UUID生成工具，或者在PowerShell中运行：

   powershell复制[guid]::NewGuid().ToString()
   

3. 发行版名称：这个可以自定义，建议使用容易识别的名字，比如"Ubuntu-20.04"。

3.2 创建注册表文件

下面是一个完整的注册表模板，你需要替换其中的几个关键字段：

reg复制Windows Registry Editor Version 5.00

[HKEY_USERS\<你的SID>\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss\{<生成的UUID>}]
"State"=dword:00000001
"DistributionName"="<发行版名称>"
"Version"=dword:00000002
"BasePath"="\\\\?\\<VHDX文件路径>"
"Flags"=dword:0000000f
"DefaultUid"=dword:000003e8

注意路径中的反斜杠需要转义，比如D:\WSL\ubuntu要写成D:\\WSL\\ubuntu。

3.3 实际案例演示

假设我的SID是S-1-5-21-3623811015-3361044348-30300820-1013，生成的UUID是8ebf13b4-6ce3-4027-a2c7-f84ab4dad111，VHDX文件放在D:\WSL\ubuntu20.04\ext4.vhdx，那么完整的注册表文件应该是：

reg复制Windows Registry Editor Version 5.00

[HKEY_USERS\S-1-5-21-3623811015-3361044348-30300820-1013\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss\{8ebf13b4-6ce3-4027-a2c7-f84ab4dad111}]
"State"=dword:00000001
"DistributionName"="Ubuntu-20.04"
"Version"=dword:00000002
"BasePath"="\\\\?\\D:\\WSL\\ubuntu20.04\\ext4.vhdx"
"Flags"=dword:0000000f
"DefaultUid"=dword:000003e8

把这个内容保存为wsl_restore.reg文件，然后双击导入注册表。

4. 验证和故障排除

4.1 验证WSL恢复情况

导入注册表后，打开终端运行：

cmd复制wsl -l -v

你应该能看到刚刚恢复的发行版，状态显示为"Running"或"Stopped"。

如果显示为"Stopped"，可以运行：

cmd复制wsl -d <发行版名称>

启动这个发行版。

4.2 常见问题解决

1. 权限问题：如果遇到访问被拒绝的错误，尝试以管理员身份运行命令提示符。

2. 路径错误：确保VHDX路径完全正确，特别是转义的反斜杠。我曾经因为少写了一个反斜杠折腾了半天。

3. 版本不匹配：Version值必须设为2，表示这是WSL 2的发行版。

4. SID错误：确保使用当前用户的SID，而不是其他用户的。在多用户系统中这一点特别重要。

5. VHDX文件损坏：极少数情况下VHDX文件可能损坏，可以尝试在PowerShell中运行：

   powershell复制Repair-VHD -Path "D:\WSL\ubuntu20.04\ext4.vhdx"
   

5. 高级技巧和最佳实践

5.1 定期备份注册表项

为了避免将来再遇到类似问题，我建议定期备份WSL的注册表项。打开注册表编辑器，导航到：

code复制HKEY_USERS\<你的SID>\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss

右键导出这个键，保存为.reg文件。这样下次可以直接导入，无需手动创建。

5.2 迁移WSL到新电脑

这个方法同样适用于将WSL环境迁移到新电脑。只需将VHDX文件复制到新电脑，然后按照上述步骤创建对应的注册表项即可。我最近换了新笔记本，用这个方法成功迁移了所有开发环境，包括配置好的开发工具和项目。

5.3 管理多个WSL实例

如果你有多个WSL发行版，可以为每个实例创建不同的注册表项。只需确保每个实例有唯一的UUID和正确的VHDX路径即可。我在一台机器上同时运行着Ubuntu、Debian和ArchLinux，都是用这种方式管理的。

5.4 性能优化建议

对于大型VHDX文件，我建议将其放在SSD硬盘上，并确保有足够的剩余空间。WSL 2的性能很大程度上取决于磁盘I/O速度。另外，定期运行：

bash复制sudo apt autoremove
sudo apt clean

可以清理不必要的文件，减小VHDX体积。