1. 为什么要在 Windows 11 上折腾 WSL 离线安装很多人第一次接触 WSL都是直接敲一句wsl --install然后等着它自己从微软的服务器上把 Ubuntu 拉下来。网络顺畅的时候这确实是最省事的做法但只要你经历过一次下载卡在 0%、进度条半天不动、或者公司内网根本连不上外部源的情况就会明白离线安装这四个字有多重要。我自己的主力开发机就是 Windows 11平时写代码、跑脚本、做数据处理都离不开 Linux 环境但办公网络对外访问限制得比较死在线安装经常失败于是硬生生把 WSL 的离线安装流程摸了个透。这篇内容要解决的核心问题很明确在没有稳定外网、或者外网速度极慢的环境下如何把 Ubuntu 22.04 完整地装进 Windows 11 的 WSL 里并且把软件源换成国内镜像让后续的apt install也能跑得飞快。它适合几类人一是公司内网受限、无法直接访问外部资源的开发者二是家里网络访问境外源速度感人、想一次性把环境搭好的同学三是需要批量给多台机器部署统一 Linux 环境的运维人员。整个流程不依赖任何特殊工具用的全是 Windows 自带能力和公开的镜像资源。先说清楚 WSL 到底是什么。WSL 全称 Windows Subsystem for Linux是 Windows 提供的一套兼容层让你能直接在 Windows 上运行 Linux 的用户态程序而不需要开虚拟机。WSL2 更进一步用了一个轻量级的虚拟化层跑真正的 Linux 内核性能和兼容性都比一代好很多。Ubuntu 22.04 LTS 是目前最主流的长期支持版本之一软件生态成熟社区资料多作为开发环境非常稳。把这两个东西组合起来你就能在 Windows 11 上得到一个几乎和原生 Linux 一致的命令行体验同时还能和 Windows 的文件系统、VS Code、Docker 等工具无缝配合。那为什么非要离线因为在线安装的本质是 WSL 去微软的 CDN 下载一个发行版镜像包这个包动辄几百 MB 到 1GB 以上。网络好的时候几分钟搞定网络差的时候可能半小时都下不完中途断了还得重来。离线安装的思路是我们自己提前把发行版镜像包下载好放到本地然后让 WSL 直接从本地文件导入。这样一来下载这一步可以借助国内镜像站或者任意能下到文件的方式完成安装过程完全不依赖网络速度快、可重复、可批量。这里有个关键概念要先建立起来WSL 的发行版本质上就是一个打包好的根文件系统rootfs通常以.tar.gz或者微软自己的打包格式存在。在线安装时WSL 帮你下载并解压这个包离线安装时我们自己下载这个包然后用wsl --import命令手动导入。理解了这一点后面所有操作就都顺了。下面我会从环境准备开始一步步把整个流程拆开讲包括镜像从哪来、怎么导入、怎么换源、怎么验证以及我踩过的那些坑。2. 动手前的环境盘点与依赖确认2.1 确认 Windows 11 版本和虚拟化支持离线安装 WSL 对系统本身有要求不是随便一台 Windows 11 都能直接上。第一步是确认你的系统版本和虚拟化功能是否就绪。按下Win R输入winver回车能看到具体的版本号。WSL2 要求 Windows 10 版本 1903 及以上、内部版本 18362 及以上Windows 11 全系都满足所以版本这块基本不用担心。真正容易出问题的是虚拟化。WSL2 依赖 Hyper-V 的底层虚拟化能力需要在 BIOS/UEFI 里开启虚拟化支持Intel 叫 VT-xAMD 叫 AMD-V同时在 Windows 功能里启用虚拟机平台和适用于 Linux 的 Windows 子系统这两个可选组件。检查虚拟化是否开启可以打开任务管理器切到性能标签页看 CPU 那一栏右下角有没有虚拟化已启用。如果显示已禁用就得进 BIOS 打开这一步不同主板操作不一样通常在 Advanced 或者 CPU Configuration 里找 Virtualization Technology 之类的选项。启用 Windows 功能有两种方式。图形界面是打开控制面板 → 程序和功能 → 启用或关闭 Windows 功能勾选适用于 Linux 的 Windows 子系统和虚拟机平台然后重启。命令行方式更利索用管理员权限打开 PowerShell执行下面两条dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完必须重启否则功能不生效。重启之后还需要确认 WSL 的内核更新包已经装上。WSL2 的 Linux 内核是独立于 Windows 更新的微软会单独发布内核更新包。离线环境下这个内核更新包wsl_update_x64.msi也需要提前下载好。如果你之前在线装过 WSL内核大概率已经是最新的如果是全新系统建议手动装一下这个 msi 包否则wsl --import导入后可能起不来。提示判断内核是否需要更新可以执行wsl --status如果提示内核版本过低或者直接报错就去装内核更新包。这个包在微软官方文档里有下载链接离线场景下提前存到本地即可。2.2 把 WSL 主程序本身准备好这里有个容易被忽略的点wsl --import这个命令本身是由 WSL 主程序提供的而这个主程序在较新的 Windows 11 上是通过 Microsoft Store 分发的。也就是说即使你要离线导入发行版WSL 的主程序还是得先存在。全新系统上如果从来没装过 WSLwsl命令可能根本不存在或者是个很老的版本。解决办法是安装适用于 Linux 的 Windows 子系统这个应用。在线情况下Store 里搜一下就能装。离线情况下可以下载它的离线安装包.msixbundle格式然后用 PowerShell 的Add-AppxPackage命令安装Add-AppxPackage .\MicrosoftCorporationII.WindowsSubsystemForLinux_xxx.msixbundle装完之后wsl --version应该能正常输出版本信息。如果提示你的 Windows 子系统版本过旧说明主程序版本太低需要更新到较新版本才能支持完整的导入导出功能。我遇到过一台老机器wsl命令存在但版本很老--import参数都不认最后就是靠更新主程序解决的。另外wsl --import和wsl --export这对命令是离线安装的核心。--export可以把一个已经装好的发行版导出成 tar 文件--import则把 tar 文件导入成一个新的发行版。理解这对命令你甚至可以在有网的机器上装好、导出再拷到没网的机器上导入这是内网批量部署最常用的套路。2.3 磁盘空间和目录规划Ubuntu 22.04 导入后初始占用大概 1GB 出头但随着你装各种开发工具很快会涨到几个 GB 甚至十几 GB。WSL2 的虚拟磁盘文件ext4.vhdx会随着使用动态增长而且默认不会自动收缩。所以规划好存放位置很重要。默认情况下wsl --import会把发行版装到你指定的目录里。我建议专门建一个目录比如D:\WSL\Ubuntu-22.04放在非系统盘上避免 C 盘被撑爆。导入命令里指定的目标目录就是虚拟磁盘的落盘位置这个目录一旦确定后续迁移比较麻烦虽然可以导出再导入所以一开始就想清楚。还有一点WSL2 的虚拟磁盘默认上限是 1TB一般够用。但如果你要做大数据处理可能需要调整。这个可以在.wslconfig文件里配置放在用户目录下C:\Users\你的用户名\.wslconfig内容类似[wsl2] memory8GB processors4 swap2GB这个文件控制 WSL2 虚拟机能用的内存、CPU 核数和交换空间。默认情况下 WSL2 会吃掉宿主机一半的内存如果你机器内存不大建议手动限制一下否则开着 WSL 再开别的重型软件会卡。3. Ubuntu 22.04 镜像从哪来离线包的获取思路3.1 官方 rootfs 包与国内镜像站离线安装的关键是拿到 Ubuntu 22.04 的 rootfs 包。这个包有几种来源我按推荐程度排一下。第一种是 Ubuntu 官方提供的 WSL rootfs 包。Ubuntu 官方为 WSL 专门构建了 rootfs文件名类似ubuntu-22.04-server-cloudimg-amd64-wsl.rootfs.tar.gz放在 Ubuntu 的 cloud-images 仓库里。这个包是官方维护的干净、可靠导入后就是一个最小化的 Ubuntu 系统。缺点是官方源在国内访问速度不稳定这时候国内镜像站就派上用场了。国内几大镜像站比如清华 TUNA、中科大 USTC、阿里云、华为云等都同步了 Ubuntu 的镜像仓库包括 cloud-images。你可以从这些镜像站下载 rootfs 包速度通常能跑满带宽。以清华源为例路径大致是https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cloud-images/下面找对应的 release 和 wsl 目录。具体路径会随镜像站结构调整建议直接进镜像站搜索wsl.rootfs关键字定位。第二种思路是曲线救国在一台有网的机器上用wsl --install -d Ubuntu-22.04正常在线装好然后用wsl --export导出成 tar 包再拷到目标机器上wsl --import。这个方法的优势是导出的包包含了在线安装时的所有初始配置兼容性最好。缺点是导出包会比官方 rootfs 大一些因为包含了安装过程中产生的一些元数据。第三种是从 Microsoft Store 的离线包入手。Store 应用本质上也是可以离线下载的有一些第三方工具能抓取 Store 应用的安装包。不过这个方法相对绕而且 Store 版本的 Ubuntu 包格式和 rootfs 不完全一样导入时可能需要额外处理我不太推荐新手走这条路。3.2 校验下载文件的完整性不管从哪个渠道下载拿到文件后第一件事是校验完整性。大文件下载过程中断或者被篡改导入时会报各种莫名其妙的错误。官方镜像站一般会提供 SHA256 校验值下载完用命令算一下对比# Linux/macOS sha256sum ubuntu-22.04-xxx.rootfs.tar.gz # Windows PowerShell Get-FileHash .\ubuntu-22.04-xxx.rootfs.tar.gz -Algorithm SHA256两个值一致才说明文件没问题。我踩过一次坑从某个非官方渠道下的包导入后系统能起来但apt各种报错折腾半天才发现是包本身损坏了。从那以后我养成了下载必校验的习惯几分钟的事能省掉后面几小时的排查。另外要注意文件格式。WSL 的--import支持.tar、.tar.gz、.tar.xz等格式但如果你下到的是.zip或者.7z得先解压出里面的 tar 包再导入。还有些镜像站提供的是.vhdx格式的虚拟磁盘那种是直接挂载用的导入方式和 tar 包不同别搞混了。3.3 国内镜像源在离线场景下的双重作用这里要区分两个概念安装包的镜像和软件源的镜像。安装包镜像是用来下载 rootfs 的解决的是怎么把系统装进去软件源镜像是系统装好之后apt install时用的解决的是装完系统后怎么快速装软件。这两个都换成国内源整个体验才完整。很多人离线装完系统就不管了结果第一次apt update卡在那里半天不动因为默认源指向的是境外的 archive.ubuntu.com。所以导入系统后的第一件事就是把/etc/apt/sources.list换成国内镜像。这一步在离线安装流程里是必须的否则你只是把系统装进来了用起来还是难受。Ubuntu 22.04 默认用的是/etc/apt/sources.list这个传统格式不是新版 deb822 格式换源就是替换文件内容。国内常用的源有清华、中科大、阿里云、华为云等选一个你网络访问最快的就行。下面给一个清华源的配置示例注意 Ubuntu 22.04 的代号是jammydeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse把这几行写进sources.list保存后执行apt update速度会有质的提升。这一步做完你的离线安装才算真正闭环。4. 导入与初始化把 Ubuntu 22.04 装进 WSL4.1 wsl --import 命令的完整参数拆解核心命令就一条但每个参数都值得说清楚wsl --import Ubuntu-22.04 D:\WSL\Ubuntu-22.04 D:\Downloads\ubuntu-22.04.rootfs.tar.gz --version 2逐个拆解。Ubuntu-22.04是你给这个发行版起的名字后续wsl -d Ubuntu-22.04就用这个名字启动起个好记的别用中文和特殊字符。第二个参数D:\WSL\Ubuntu-22.04是安装目录WSL 会在这里生成ext4.vhdx虚拟磁盘文件这个目录必须存在WSL 不会自动创建。第三个参数是 rootfs 包的路径支持绝对路径和相对路径。--version 2明确指定用 WSL2不加的话在某些系统上可能默认用 WSL1性能和兼容性都差一截。导入过程其实就是把 tar 包解压到虚拟磁盘里几百 MB 到 1GB 的包机械硬盘上可能要一两分钟SSD 上几十秒就完事。导入完成后不会有花哨的提示命令行直接返回这时候用wsl -l -v就能看到新导入的发行版状态是 Stopped。有个细节要注意导入后的默认用户是 root不是普通用户。这是离线导入和在线安装最大的区别之一。在线安装时Ubuntu 会引导你创建一个普通用户并设置密码离线导入的 rootfs 里没有这个引导过程所以你进去就是 root。用 root 日常操作不是不行但不太安全也不符合习惯所以下一步就是创建普通用户。4.2 创建普通用户并配置默认登录先用 root 身份进入系统wsl -d Ubuntu-22.04进去之后创建一个和你 Windows 用户名对应的普通用户比如叫devuseradd -m -s /bin/bash dev passwd dev-m表示同时创建家目录-s指定默认 shell 为 bash。然后给这个用户加上 sudo 权限usermod -aG sudo dev接下来配置 WSL 默认用这个用户登录。有两种方式。第一种是在发行版内部写配置文件编辑/etc/wsl.conf[user] defaultdev保存后退出 WSL在 PowerShell 里执行wsl --terminate Ubuntu-22.04重启这个发行版再进去就是dev用户了。第二种方式是在 Windows 端用命令设置但wsl.conf这种方式更通用迁移到别的机器也带着走我推荐用这种。注意/etc/wsl.conf的修改需要重启 WSL 实例才生效光退出终端不够必须wsl --terminate或者wsl --shutdown。这个坑我踩过改完配置发现没生效以为配置写错了其实是没重启。4.3 首次启动后的基础配置普通用户建好之后还有几件基础的事要做。第一是更新软件源并升级系统前面换源之后执行sudo apt update sudo apt upgrade -y这一步会拉取最新的软件包列表并升级已安装的包。离线环境下如果暂时没网可以先跳过等有网了再补。第二是配置时区和语言环境。默认 rootfs 的时区可能是 UTC改成东八区sudo timedatectl set-timezone Asia/Shanghai语言环境方面如果locale输出有警告可以装一下语言包sudo apt install -y locales sudo locale-gen en_US.UTF-8 zh_CN.UTF-8第三是确认网络。WSL2 默认走 NAT 模式能正常访问外部网络。用ping或者curl测一下curl -I https://mirrors.tuna.tsinghua.edu.cn如果这一步不通检查 Windows 的防火墙或者 DNS 设置。WSL2 的 DNS 有时候会抽风表现为能 ping 通 IP 但域名解析不了这种情况可以手动改/etc/resolv.conf或者用wsl.conf里的generateResolvConffalse关掉自动生成手动指定 DNS。5. 换源加速让 apt 和常用工具都跑起来5.1 备份并替换 sources.list换源之前先备份原文件这是个好习惯出问题能快速回滚sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak然后用你熟悉的编辑器打开/etc/apt/sources.list把内容全部替换成国内源。除了前面给的清华源中科大源也很稳deb https://mirrors.ustc.edu.cn/ubuntu/ jammy main restricted universe multiverse deb https://mirrors.ustc.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse deb https://mirrors.ustc.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse deb https://mirrors.ustc.edu.cn/ubuntu/ jammy-security main restricted universe multiverse如果你不确定哪个源快可以几个都试试用curl测一下响应时间。换完执行sudo apt update观察下载速度。正常情况下国内源能跑到几 MB/s 甚至更高比默认源快一个数量级。有个细节Ubuntu 22.04 的sources.list里如果混用了http和https或者源地址写错apt update会报错。报错信息里会明确指出哪一行有问题照着改就行。另外某些公司内网会拦截https流量这种情况把源地址改成http试试。5.2 其他常用工具的国内镜像配置系统源换完只是第一步实际开发中还会用到 pip、npm、docker 等工具它们各自有自己的源也建议一并换成国内镜像否则装个 Python 包等半天。pip 的配置创建~/.pip/pip.conf[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cnnpm 的配置npm config set registry https://registry.npmmirror.comDocker 的镜像源配置在/etc/docker/daemon.json不过 WSL 里装 Docker 通常是直接用 Docker Desktop 的 WSL 集成或者装 docker-ce配置方式略有不同。如果是在 WSL 里独立装 Docker编辑 daemon.json{ registry-mirrors: [https://docker.mirrors.ustc.edu.cn] }这些配置看起来琐碎但一次性配好后面省心很多。我的习惯是装完系统后写一个初始化脚本把这些源配置、常用工具安装都串起来新机器导入后跑一遍脚本就完事。5.3 验证换源效果与常见报错换源后执行sudo apt update正常输出应该是每个源地址后面跟着Hit或者Get最后显示有多少包可以升级。如果出现Could not resolve或者Connection timed out说明源地址不通换一个源或者检查网络。常见的报错还有Release file is not valid yet这通常是系统时间不对导致的。WSL2 的时间一般和 Windows 同步但如果 Windows 时间本身不准WSL 里也会跟着错。执行date看一下不对的话在 Windows 端同步一下时间或者手动设置。还有一种报错是NO_PUBKEY表示缺少 GPG 公钥。这个在换源后偶尔出现执行提示里的命令导入公钥即可通常是sudo apt-key adv --keyserver ...或者sudo apt install ubuntu-keyring。Ubuntu 22.04 推荐用signed-by方式管理密钥不过对于官方源一般不会遇到这个问题。6. 踩坑实录离线安装中最容易翻车的几个点6.1 导入后启动报错 0x800701bc这个错误码是 WSL 离线安装里出现频率最高的。现象是wsl --import成功但一启动就报The Windows Subsystem for Linux instance has terminated或者直接弹 0x800701bc。根本原因是 WSL2 的 Linux 内核没有安装或者版本太旧。前面 2.1 节提到的内核更新包就是解决这个的。去下载wsl_update_x64.msi装上然后执行wsl --set-default-version 2确保默认版本是 2再重新启动发行版。如果还是不行执行wsl --update强制更新内核这个需要网络或者手动指定内核路径。还有一种情况是虚拟化没开。虽然wsl --import不报错但启动时因为底层虚拟化不可用而失败。回到 2.1 节确认 BIOS 里的虚拟化开关和 Windows 功能都开了。6.2 导入的发行版默认用户是 root 的连锁反应前面说过离线导入默认是 root这个问题本身好解决但它会引发一系列连锁反应。比如你用 root 装了一些工具配置文件都写在了/root下后来切到普通用户发现工具用不了因为配置不在~里。又比如某些工具检测到 root 身份会改变行为或者拒绝运行。我的建议是导入后第一件事就是创建普通用户并设为默认然后再开始装任何东西。顺序反了后面清理起来很麻烦。如果已经用 root 装了一堆东西可以把/root下的相关配置拷到普通用户家目录并改一下属主sudo cp -r /root/.config /home/dev/ sudo chown -R dev:dev /home/dev/.config6.3 磁盘空间只增不减的虚拟磁盘WSL2 的ext4.vhdx是个动态磁盘用多少涨多少但删了文件它不会自动缩回去。用久了你会发现这个文件可能有几十 GB但系统里df -h显示只用了几个 GB。这是 WSL2 的已知行为不是 bug。解决办法是手动压缩。先关闭 WSLwsl --shutdown然后用diskpart或者Optimize-VHD压缩。diskpart的方式是diskpart # 进入 diskpart 后 select vdisk fileD:\WSL\Ubuntu-22.04\ext4.vhdx attach vdisk readonly compact vdisk detach vdisk exit压缩过程可能比较慢取决于磁盘大小。压缩完ext4.vhdx会明显变小。这个操作建议定期做尤其是你经常在 WSL 里编译、删文件的话。6.4 网络与 DNS 的间歇性抽风WSL2 的网络走的是 NAT宿主机和 WSL 之间通过虚拟网卡通信。大部分时候没问题但偶尔会出现 DNS 解析失败、或者访问某些地址超时。表现是ping 8.8.8.8通但ping baidu.com不通。根因通常是 WSL 自动生成的/etc/resolv.conf指向了一个不可用的 DNS。可以手动改sudo rm /etc/resolv.conf sudo bash -c echo nameserver 223.5.5.5 /etc/resolv.conf但这样改重启后会失效因为 WSL 会重新生成。要永久生效在/etc/wsl.conf里加[network] generateResolvConf false然后手动维护/etc/resolv.conf。注意关掉自动生成后这个文件不会被 WSL 覆盖但你需要确保它一直存在且内容正确。7. 从离线安装到日常使用的衔接7.1 和 VS Code 的配合装好 WSL 后最常用的搭配就是 VS Code。在 Windows 上装好 VS Code再装一个 WSL 扩展然后在 WSL 终端里进入项目目录执行code .VS Code 就会以远程模式打开这个目录编辑器跑在 Windows 上终端和运行环境在 WSL 里体验非常顺。这里有个离线场景的坑VS Code 的 WSL 扩展需要在 WSL 里装一个 server 组件这个组件默认是从微软服务器下载的。如果 WSL 里网络受限code .会卡在 Installing VS Code Server。解决办法是提前在有网的机器上装好或者手动下载 server 包放到指定目录。VS Code 的 server 包下载地址可以从它的更新日志里找到放到~/.vscode-server/bin/下对应版本号的目录里即可。7.2 文件系统互访的正确姿势WSL 和 Windows 之间可以互相访问文件。Windows 访问 WSL 文件通过\\wsl$\Ubuntu-22.04\这个路径WSL 访问 Windows 文件通过/mnt/c/、/mnt/d/这些挂载点。但这里有个性能陷阱不要在/mnt/c/下跑 Linux 项目。因为跨文件系统的 IO 性能很差npm install或者编译操作会慢到怀疑人生。正确做法是把项目放在 WSL 自己的文件系统里比如~/projects需要和 Windows 共享的文件才放到/mnt/下。这个坑几乎每个 WSL 新手都会踩我当初也是把项目放在 Windows 盘里装个依赖等了好几分钟后来挪到 WSL 内部秒装。7.3 备份与迁移export 的妙用离线安装的流程反过来就是备份流程。当你把环境配置得差不多想备份一份或者想迁移到另一台机器用wsl --exportwsl --export Ubuntu-22.04 D:\Backup\ubuntu-22.04-backup.tar导出的 tar 包包含了整个系统包括你装的所有软件和配置。换机器时在新机器上wsl --import这个包环境原样恢复。这个套路在内网批量部署时特别有用在一台机器上配好标准环境导出然后分发到其他机器导入省去重复配置的时间。导出前建议先清理一下系统删掉缓存和临时文件能显著减小包体积sudo apt clean sudo rm -rf /tmp/*导出的包大小取决于你装了多少东西纯净系统大概 1GB 左右装了开发环境可能 5GB 以上。压缩一下再传更省事tar 包本身可以再 gzip 一层。7.4 一些提升日常体验的小配置最后分享几个让 WSL 用起来更舒服的配置。第一是给apt开启并行下载在/etc/apt/apt.conf.d/下新建一个文件写入Acquire::Languages none; Acquire::http::Pipeline-Depth 10;第二是配置 git 的用户信息和常用别名这些在 WSL 里重新配一遍就行。第三是如果你用 Windows Terminal可以把 WSL 发行版加到配置文件里设置好字体和配色用起来比默认终端舒服很多。还有个小技巧WSL 的启动速度可以通过wsl.conf里的[boot]段配置启动命令比如自动启动某些服务。不过别塞太多东西否则每次开终端都要等。我一般只放必要的环境变量和路径配置。整个离线安装流程走下来核心其实就是三件事准备好 rootfs 包、用wsl --import导入、换国内源。听起来简单但每个环节都有细节尤其是内核版本、默认用户、磁盘压缩这几个点不注意就会卡住。我自己的经验是第一次装的时候把每一步都记下来形成自己的 checklist以后再装就是照着走一遍的事。环境这种东西一次配好后面省下的时间远超投入。