WSL 子系统备份与迁移指南（以 Ubuntu 为例）

WSL 子系统备份与迁移指南（以 Ubuntu 为例）

在使用 WSL (Windows Subsystem for Linux) 进行开发工作时，备份和迁移 WSL 子系统是一项重要的维护任务。本指南将详细介绍如何备份、迁移和恢复 WSL Ubuntu 子系统，确保您的开发环境可以安全地转移到新的计算机或在系统重装后恢复。

1. WSL 子系统备份

1.1 导出为 TAR 文件（官方推荐方法）

这是 Microsoft 官方推荐的备份 WSL 发行版的方法：

# 在 PowerShell 中执行（管理员权限）
wsl --export Ubuntu D:\Backups\ubuntu-backup.tar

参数说明：

• Ubuntu 是您的 WSL 发行版名称（可通过 wsl -l -v 查看）
• D:\Backups\ubuntu-backup.tar 是备份文件的保存路径

1.2 直接复制 VHDX 文件（适用于 WSL2）

WSL2 使用虚拟硬盘文件 (VHDX) 存储整个文件系统：

# 首先关闭 WSL 实例
wsl --shutdown

# 复制 VHDX 文件（在 PowerShell 中执行）
$userFolder = $env:USERPROFILE
$wslFolder = "$userFolder\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc\LocalState"
Copy-Item "$wslFolder\ext4.vhdx" -Destination "D:\Backups\ubuntu-wsl.vhdx"

注意：具体的包名可能因 Ubuntu 版本而异，您可能需要在 AppData\Local\Packages 目录下查找正确的文件夹。

1.3 备份特定目录或文件

如果只需要备份特定的项目或配置：

# 在 WSL 中执行
tar -czvf ~/important-files-backup.tar.gz /path/to/important/directory

# 然后将备份文件复制到 Windows
cp ~/important-files-backup.tar.gz /mnt/c/Users/YourUsername/Desktop/

2. WSL 子系统迁移

2.1 使用官方导入方法

将备份的 TAR 文件导入到新系统：

# 在新系统的 PowerShell 中执行（管理员权限）
# 首先确保已安装 WSL
wsl --install

# 导入备份文件
wsl --import Ubuntu D:\WSL\Ubuntu D:\Backups\ubuntu-backup.tar

参数说明：

• Ubuntu 是新 WSL 实例的名称
• D:\WSL\Ubuntu 是新 WSL 实例的安装位置
• D:\Backups\ubuntu-backup.tar 是备份文件的路径

2.2 使用 VHDX 文件恢复（适用于 WSL2）

如果您备份了 VHDX 文件：