核心需求
- 装 WSL 2 版本的 Ubuntu 22.04（WSL 1 兼容性太差，怕后续跑工具出问题）；
- 系统必须放 D 盘，C 盘空间实在扛不住；
- 不用国内镜像源，优先用微软官方渠道；
- 步骤简单好懂，别搞太复杂的操作。
最开始尝试导入 ubuntu2204.tar 文件时直接报错，发现并非现成的 WSL 镜像可用。
常见错误排查
坑 1：导入时直接报'未指定的错误'
在 PowerShell 里执行导入命令：
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\WSL\ubuntu2204.tar --version 2
结果弹出'未指定的错误'。反复核对路径、文件名后问题依旧。
坑 2：想查 WSL 版本，却提示'命令无效'
输入 wsl --version 报错'命令行选项无效'。此时意识到 WSL 是 Windows 自带的旧版本（收件箱版本），不支持基础命令，更无法兼容新版 Ubuntu 的导入。
坑 3：升级 WSL 后，才发现 tar 包格式错了
升级完 WSL 再导入，报错具体了：
Ubuntu_2204.1.7.0_x64.appx: ZIP uncompressed data is wrong size (read 574740460, expected 0) bsdtar: Error exit delayed from previous errors. 导入分发失败。错误代码：Wsl/Service/RegisterDistro/WSL_E_IMPORT_FAILED
原来手里的 ubuntu2204.tar 是被重命名的 Windows 应用商店 APPX 安装包（本质是 ZIP 格式）。WSL 导入只认包含 Linux 根目录（/bin、/etc 等）的纯净 tar 包，APPX 包完全不兼容。
坑 4：在 Ubuntu 终端里跑 Windows 命令
中间犯了个低级错：想关 WSL 实例，在 Ubuntu 终端里输 wsl --shutdown，提示'wsl: command not found'。后来分清：wsl 是 Windows 命令，只能在 PowerShell 里用；Ubuntu 终端里只能跑 Linux 命令。
安装与迁移步骤
更新 WSL 是解决所有兼容性问题的关键。旧版 WSL 的 bug 太多，不管是导入报错还是命令无效，更新后基本都能解决。
步骤 1：升级 WSL 到最新版
打开「管理员 PowerShell」（后面所有 Windows 端命令都在这执行），输入升级命令：
wsl --update
等待几分钟，更新完成后如果提示重启，就重启电脑。这一步千万别省，之前所有的'未指定错误'，本质都是旧版 WSL 的兼容问题。
步骤 2：用微软官方命令一键装 Ubuntu 22.04
直接用 WSL 官方一键安装命令，自动从微软服务器下载正确的镜像：
wsl --install -d Ubuntu-22.04
执行后会自动下载、配置 WSL 2，完成后会自动弹出 Ubuntu 终端，按提示操作：
- 输入 UNIX 用户名（设为
szx，随便起，不用和 Windows 用户名一致）；
