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 路径名缩写
- What Is the AppData Folder in Windows? (howtogeek.com)
- AppData – Where to Find the AppData Folder in Windows 10 (freecodecamp.org)
- Windows special folders short names (%something%) – PCR’s notepad (patheticcockroach.com)
- How do I find AppData\LocalLow folders? - Microsoft Community
WSL 安装和使用
参见 “使用 WSL 2 进行工作”.
-
即
X:/Users/%UserName%/AppData/Local/Packages. 另见参考资料中 “关于 Windows 路径名缩写”. ↩︎ -
参考 @synergies 的评论回复. ↩︎
Last modified on 2022-09-18