核心需求
- 装 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 用户名一致);

