Windows 10 离线安装 WSL2 Ubuntu 22.04.5 LTS 实战指南
背景
近期在 Windows PC 上尝试通过 WSL2 运行本地 AI 模型时，遇到网络限制导致在线安装失败（错误代码 0xc8000641）。本文将分享通过手动下载镜像并离线导入的成功方案，适用于企业内网隔离或微软商店访问受限的场景。
一、准备工作
1. 系统要求
- 操作系统：Windows 10 2004+ (Build 19041+) 或 Windows 11
- 硬件虚拟化：BIOS/UEFI 中需启用 Intel VT-x 或 AMD-V
- 存储空间：至少 5GB 空闲空间（建议 SSD）
2. 启用 WSL 功能
以管理员身份运行 PowerShell，依次执行以下命令开启必要组件：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2
Restart-Computer
若习惯图形界面，也可打开【控制面板】→【程序】→【启用或关闭 Windows 功能】，勾选虚拟机平台和适用于 Linux 的 Windows 子系统，重启生效。
二、手动下载 Ubuntu 镜像
由于无法在线获取，需手动下载 .AppxBundle 文件。可访问 Microsoft Learn 文档页面查找 Ubuntu 22.04 的官方下载链接，或使用备用源。
将下载的 Ubuntu2204-221101.AppxBundle 保存至本地路径，例如 C:\wsl\。
三、离线安装 Ubuntu 22.04
1. 打开 PowerShell
按 Win + X，选择 Windows PowerShell（管理员） 或 Windows Terminal（管理员）。
2. 导航到镜像目录
cd C:\wsl\
3. 执行安装命令
确保文件名无误后，输入以下命令：
Add-AppxPackage .\Ubuntu2204-221101.AppxBundle
⚠️ 注意事项
- 必须使用管理员权限，否则可能报权限错误。
- 若提示找不到包，可用
dir确认文件名，或用 Tab 键自动补全。- 如安装失败，请检查是否启用了'旁加载应用'（设置 → 应用 → 从其他来源安装）。
四、初始化与验证
安装成功后，开始菜单会出现 Ubuntu 22.04 图标。首次运行会进入初始化流程：
- 创建 UNIX 用户名：输入小写字母组成的账户名（如
tom），不能含空格或大写字母。 - 设置密码：输入时不显示字符，需牢记以便后续 sudo 操作。
- 确认密码：再次输入相同密码。
完成后，可通过以下命令验证环境：
# 检查当前用户
whoami
# 检查 WSL 版本
wsl --list --verbose
若输出显示 VERSION 2，说明 WSL2 已正常启用。建议首次登录后更新软件源：
sudo apt update && sudo apt upgrade -y
五、常见问题排查
- 路径规范：安装目录避免包含中文或空格。
- 权限问题：始终确保 PowerShell 为管理员模式。
- 镜像完整性：下载后建议校验 SHA256 值，防止文件损坏。
至此，WSL2 Ubuntu 环境已部署完毕，可直接用于开发或运行本地模型。
