WSL Ubuntu 发行版启动失败且无法导出。通过检查服务状态、重置 Windows 功能确认虚拟化层正常但 Ubuntu 实例损坏。利用 Debian 环境配合 qemu-nbd 挂载 VHDX 文件提取用户数据，最终重装干净 Ubuntu 并迁移用户目录完成恢复。
近期使用 WSL（从 VSCode）时，电脑运行卡顿。随后 Ubuntu 终端直接无法启动，显示黑屏。
以管理员身份打开 PowerShell，运行：
wsl --list --verbose
输出 STATE 为'Stopped'，说明 WSL 未启动。
再运行：
wsl -d Ubuntu
启动过程卡死。判定是整个 distro 无法运行，还是 shell 启动阶段出了问题。
运行：
wsl -d Ubuntu --exec echo hello
依旧卡住。连最简单的 都挂住，说明问题出在 WSL 服务本身或底层虚拟化。
--exec echo检查 WSL 服务状态，运行：
Get-Service LxssManager
报错。参考 Microsoft Q&A 文档，再运行：
Get-Service WslService
显示 Status 为'Running'，说明 WSL 服务本身没问题。
检查 WSL 配置和内核版本，运行：
wsl --status
仍然卡住。
接下来把 WSL 的 Windows 功能彻底重置一下：
dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux /norestart
dism.exe /online /disable-feature /featurename:VirtualMachinePlatform /norestart
dism.exe /online /disable-feature /featurename:HypervisorPlatform /norestart
DISM /Online /Cleanup-Image /RestoreHealth
sfc /scannow
时间稍久，完成后重启。
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:HypervisorPlatform /all /norestart
再次尝试：
wsl --list --verbose
wsl --status
wsl -d Ubuntu --exec echo test
前两步有输出，最后一步仍卡住。
调整思路，测试另外一个发行版：
wsl --list --online
wsl --install -d Debian
wsl -d Debian --exec echo ok
输出正常！说明 WSL2 核心和虚拟化平台没问题，唯一出问题的是 Ubuntu 实例本身已损坏。接下来需要备份虚拟磁盘文件。
运行
wsl --export Ubuntu D:\WSL-backups\ubuntu-backup.tar
中途卡住。直接在系统中找到 ext4.vhdx 文件（一般在 C:\Users\...\AppData\Local\Packages\…\LocalState\ext4.vhdx）复制粘贴，也失败。
既然 Debian 下能正常挂载和执行，说明 WSL2 平台没问题，只是 Ubuntu 的 VHDX 文件里，连导出都卡死了——通常是因为 distro 本身有某些元数据或元件损坏，导致 wsl --export、wsl --set-version 整个流程都挂在底层 IO 上。
借助 WSL 自身的'挂载虚拟磁盘'功能，把那块 ext4.vhdx 当作一个普通磁盘在 Debian 里挂载，然后从里面把文件打包出来。
输入
wsl --shutdown
wsl --mount "C:\Users\…\AppData\Local\Packages\…\LocalState\ext4.vhdx" --type ext4
报错：无法将磁盘附加到 WSL2: The parameter is incorrect. 错误代码：Wsl/Service/AttachDisk/MountDisk/E_INVALIDARG。
尝试另一种方法——在 Debian 里用 qemu-nbd（网络块设备）来映射这个 VHDX，再手动挂载 ext4 分区，然后把文件 rsync/打包出来。
wsl --shutdown
wsl -d Debian
sudo apt update
sudo apt install -y qemu-utils
# 加载 nbd 模块
sudo modprobe nbd max_part=8
# 只读方式将 ext4.vhdx 映射到 /dev/nbd0
sudo qemu-nbd -r -c /dev/nbd0 /mnt/c/Users/.../AppData/Local/Packages/.../LocalState/ext4.vhdx
lsblk
# 挂载 ext4 文件系统
sudo mkdir -p /mnt/oldubuntu
# 加上 noload 选项来跳过日志回放，从而强制挂载
sudo mount -t ext4 -o ro,noload /dev/nbd0 /mnt/oldubuntu
没有输出，说明挂载成功了。接下来打包文件：
sudo tar czpf /mnt/e/WSL-backups/ubuntu-backup.tar.gz \
-C /mnt/oldubuntu .
打包中有一些错误都是因为只读挂载的 ext4 日志未清理、某些缓存文件或损坏文件导致 tar 无法正常读取。一般来说，这些报错都在系统缓存、snap 缓存、.cache、Anaconda 包等可重新生成或非关键目录，不会影响最关心的 /home 里用户数据。
然后卸载并断开网络块设备：
sudo umount /mnt/oldubuntu
sudo qemu-nbd -d /dev/nbd0
最后退出 Debian。
在相应位置可以看到压缩包，包中有之前 Ubuntu 系统中的文件，包括 /home 里的数据。
有了备份就可以后续重装系统和重新导入文件了。
导入备份包
wsl --import Ubuntu C:\WSL\Ubuntu E:\WSL-backups\ubuntu-backup.tar.gz --version 2
结果各种失败。基础的系统二进制被漏掉了。例如，tar 提示了大量'Read error'和'File shrank by … padding with zeros'，说明在 /usr/bin/, /bin/ 等目录下的可执行文件没能完整读取出来。结果就是：导入的新实例里不再有 /bin/bash、/bin/ls、/usr/bin/apt 这些核心工具，它根本不是一个'完整'的 Ubuntu 了。
因此，最稳妥的做法是：首先，新安装一个干净的 Ubuntu（WSL 官方版）；然后，把原来真正关心的用户目录（比如 /home/username）里的配置和文件复制过来。
安装发行版：
wsl --install -d Ubuntu-22.04
新创建一个目录，把备份包里的 /home/ 内容解压到目录：
mkdir C:\WSL-backups\backup-root
在 WSL 里执行 tar 解压，因为可以带 --ignore-failed-read 忽略损坏文件：
wsl -d Debian
# 在 Debian 里创建输出目录（对应 Windows 的 C:\WSL-backups\backup-root）
sudo mkdir -p /mnt/c/WSL-backups/backup-root
# 用 tar 只提取以 "./home" 开头的那一级目录及其所有子文件
sudo tar --ignore-failed-read --warning=no-file-changed \
-xzpf /mnt/e/WSL-backups/ubuntu-backup.tar.gz \
-C /mnt/c/WSL-backups/backup-root \
"./home"
exit
然后启动新的 Ubuntu，把解压的 /home/ 内容迁进去：
# 启动新的 Ubuntu 并切换到 root
wsl -d Ubuntu
sudo -i
# 确保有一个名叫 username 的用户，并清空它的 home 目录
rm -rf /home/username
mkdir -p /home/username
chown username:username /home/username
# 从 Windows 侧把备份/home/目录拷进来
rsync -aHAX --numeric-ids /mnt/c/WSL-backups/backup-root/home/username/ /home/username/
# 修正属主和权限，这样可以确保此后的登录和运行一切都是 username 用户权限
chown -R username:username /home/username
exit
# 退出 root，回到 username（如果你当前还是 root）
exit
# 退出 WSL
然后就可以测试是否恢复成功。
可能是电脑硬件老化影响了系统，笔记本已经用了 6 年。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online