WSL2这个东西用过就回不去了。但真正麻烦的不是它好不好用而是怎么在一台断网的机器上把它装起来。我遇到过不止一次生产内网机器、客户机房、甚至家里那台老笔记本系统是Windows 10 21H2网络要么没有要么慢到wsl --update卡在0%半天不动。这时候如果手边没有一套现成的离线安装包就只能干瞪眼。这篇文章就把我这两三年反复折腾WSL2离线安装的经验写出来从环境检查、文件准备、功能开启、内核安装、发行版导入到常见坑一条龙讲清楚。看完你也能在完全没外网的环境下把WSL2稳稳当当用起来。1. 为什么我要折腾离线安装WSL21.1 WSL2是什么离线安装和非离线有什么不同WSL2的全称是Windows Subsystem for Linux 2是微软在Windows 10 2004版本之后推出的第二代Linux子系统。它和第一代WSL1最大的区别是使用了真正的Linux内核通过轻量级虚拟机的方式运行而不是像WSL1那样做一层的系统调用翻译。这样一来绝大多数Linux二进制程序都能原生跑Docker、CUDA、TensorFlow这些重工具在WSL2里的表现和真实Linux机器差距很小。我平时写后端、跑人工智能模型、处理数据都直接在WSL2里干Windows这边只负责编辑器、浏览器和日常通讯舒适度很高。在线安装WSL2很简单打开PowerShell执行wsl --install它会自动帮你开功能、装内核、装发行版一路顺畅。但离线环境就麻烦了。离线意味着Windows更新连不上应用商店连不上甚至微软的下载服务器也连不上。而WSL2的安装流程偏偏依赖这些在线资源需要下载WSL内核更新包需要下载Ubuntu这类发行版镜像有时还需要升级wsl.exe本身。离线安装要做的事情本质上就是把这些本来需要在线获取的东西提前下载好带到目标机器上手动装。1.2 适合离线安装的真实场景我整理了一下离线安装WSL2主要出现在下面几类场景企业内网和隔离网环境。很多公司的研发网和生产网严格隔离机器不允许接入互联网。开发者想在本地用Linux工具链只能在内网环境中安装WSL2。机房批量交付。给客户交付一批Windows服务器要求预装好WSL2和指定Ubuntu版本。这些机器在交付前可能没有接入外网或者网速极不稳定批量配置时离线安装反而更可控。老旧笔记本或临时设备。有的旧电脑升级到Win10后无线网卡驱动有问题或者网络下载速度感人在线安装WSL2基本等不起。企业安全策略限制。部分安全软件会拦截系统组件在线安装但允许管理员手动执行安装包。这些场景的共同点是“网络不可靠或不可用”但用户对WSL2的需求又是刚需。离线安装就成了唯一的出路。1.3 离线安装的整体思路离线安装WSL2并不神秘核心思路就是四个字提前囤货。我们需要准备四样东西Windows必选功能Microsoft-Windows-Subsystem-LinuxWSL功能和VirtualMachinePlatform虚拟机平台。这两个功能在Windows系统镜像自带的组件里离线机器也能通过DISM命令开启。WSL2内核更新包微软官方提供的MSI安装包文件名类似wsl_update_x64.msi。这个包负责把WSL2需要的Linux内核安装到Windows上。Linux发行版离线包可以是微软商店的.appx格式也可以是从已有WSL导出的.tar格式或者是云镜像平台提供的rootfs压缩包。一个能用的wsl.exe。新版Windows自带的wsl.exe已经支持wsl --install但离线机器如果版本低老一点的内核配合手动安装的MSI也够用。把这几样准备齐了离线的安装流程就是开功能、重启、装内核、导入发行版。下面的内容我会按这个流程一步步拆开讲。2. 先查环境别急着下载安装包2.1 Windows系统版本和硬件要求离线安装之前第一步永远是确认目标机器的Windows版本和芯片支持情况。WSL2有硬性要求不是随便一台Win10都能装。项目要求Windows 10版本2004Build 19041及以上或Windows 11Windows Server2019 / 2022需要安装相应功能CPU支持虚拟化需要开启VT-xIntel或AMD-VAMD且在BIOS/UEFI中启用内存建议至少4GB跑编译任务推荐8GB以上硬盘至少20GB可用空间如果装多个发行版建议更多如果机器是Windows 10 1909或更早版本那只能装WSL1装不了WSL2。这种情况要么升级系统要么放弃WSL2改用其他方案。在给客户交付时我最怕的就是现场发现系统版本不够所以动手前我会先拿到系统信息再准备材料。2.2 虚拟化是否开启三条命令判断WSL2是用Hyper-V虚拟化技术跑的CPU虚拟化没开一切白搭。判断方法很简单管理员权限打开PowerShell或CMD运行systeminfo在输出信息的最下方找到“Hyper-V 要求”部分。如果看到“已在固件中启用虚拟化: 是”说明CPU虚拟化已经打开。如果显示“否”就需要进BIOS/UEFI开启Intel Virtualization Technology或AMD SVM Mode然后重启。也可以运行msinfo32打开系统信息窗口在“系统摘要”里找“基于虚拟化的安全性”和“虚拟化固件中已启用”这两个条目。还有一条命令可以查Hypervisor是否已经在运行bcdedit /enum {current} | find hypervisorlaunchtype如果输出hypervisorlaunchtype Auto说明Hyper-V已经处于启动状态。如果输出OffWSL2的虚拟机平台可能没跑起来。这里有个容易踩的坑有些机器的CPU虚拟化在BIOS里明明开了但Windows里还是显示“未启用”。这往往是因为启用了“基于虚拟化的安全性”VBS或“内核隔离-内存完整性”导致Hypervisor被占用或冲突。遇到这种情况我一般先看msinfo32里的“基于虚拟化的安全性”是否显示“正在运行”如果是可以把“内核隔离”临时关掉再测试。2.3 目标机上的可选功能状态开启WSL2需要两个Windows可选功能Microsoft-Windows-Subsystem-Linux和VirtualMachinePlatform。在离线机器上可以用DISM命令直接查询哪些功能是由系统镜像自带的dism.exe /online /get-feature /format:table | findstr Subsystem VirtualMachinePlatform正常情况下会看到两个功能的名称以及“启用/禁用”状态。如果功能在系统映像中存在那么即便离线也能安装。如果查不到就需要检查系统版本或系统镜像是否完整。这一步很重要因为有些精简版Windows为了减少体积把可选功能组件裁剪掉了。真遇到这种情况离线安装就会失败只能换一个完整版系统或重新安装官方原版镜像。3. 在联网机器上准备离线安装材料3.1 WSL2内核更新包怎么下载最核心的文件是WSL2 Linux内核更新包。微软官方下载地址是https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package页面上提供wsl_update_x64.msi64位版和ARM64版。绝大多数机器选择x64版。下载完成后建议用PowerShell校验一下哈希防止文件损坏Get-FileHash .\wsl_update_x64.msi -Algorithm SHA256然后把MSI文件拷到U盘或内网共享目录。这个MSI包就是离线安装WSL2内核的关键它能在完全无网的情况下完成内核安装这个环节。如果你在目标机上用的是新版WSL通过Microsoft Store发布的版本它还会自动更新内核。但在离线环境下商店连不上所以最稳妥的做法是安装完MSI后不要让wsl.exe强制去商店更新或者使用带--web-download参数的旧版命令时保持谨慎。后面我会专门讲“wsl --update卡住”这个坑。3.2 Linux发行版离线包appx和tar两种选择离线安装Linux发行版我习惯准备两种格式根据目标机器情况灵活选择。第一种是微软商店包也就是.appx或.msixbundle。你可以从微软商店的“网页版”链接直接下载。以Ubuntu 22.04 LTS为例官方下载地址是https://aka.ms/wslubuntu2204下载下来通常是一个Ubuntu_2204.1.7.1_x64.appx文件或者是一个带.msixbundle后缀的多架构包。之后在目标机器上通过PowerShell命令Add-AppxPackage安装相当于手动完成商店安装动作。第二种是.tar格式的rootfs或发行版导出包。这种格式更通用适合离线导入。获取方式有两种从一台已经装好WSL2的机器上导出wsl --export 发行版名称 ubuntu2204.tar从Ubuntu云镜像网站下载官方WSL rootfs压缩包https://cloud-images.ubuntu.com/wsl/目录下有类似ubuntu-22.04-wsl-amd64-...tar.gz的文件。我推荐同时准备这两种格式。appx适合走标准商店安装流程tar格式配合wsl --import更灵活还能直接放到非C盘目录。3.3 准备辅助工具和软件源除了WSL2本身如果你还想在离线机器上装Python、Node.js、Docker等就需要顺便把软件安装包也准备好。我常做的准备有下载Miniconda离线安装脚本、Node.js官方二进制包或者各种deb包。如果内网有Linux软件源镜像把源地址记录下来安装完系统后配置到/etc/apt/sources.list。如果内网没有软件源可以用apt-get download在联网机器上把依赖包批量下载下来再拷进去用apt-get install ./*.deb安装。别小看这些准备工作很多时候WSL2装好了结果用户发现里面连gcc都没有还得折腾内网源体验就很差。离线部署讲究“一套材料到位”提前多花十分钟现场能省两小时。4. 目标机离线安装全流程4.1 用DISM开启WSL和虚拟机平台功能在目标机器上以管理员身份打开PowerShell或CMD执行两条命令dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart第一条命令开启WSL基本功能第二条开启虚拟机平台。这两步都是使用本地系统镜像完成不需要联网。/all参数表示同时启用所有父级功能/norestart表示暂时不重启。执行完后需要重启系统让功能生效。这里我一般不会用/norestart参数直接让DISM返回后手动重启确保一切干净。重启后可以用查询命令确认dism.exe /online /get-feature /format:table | findstr Subsystem VirtualMachinePlatform这时两个功能应该显示为“启用”。4.2 安装WSL2内核更新包重启完成后把提前准备好的wsl_update_x64.msi拷到目标机器双击运行或者在管理员PowerShell中执行msiexec.exe /i .\wsl_update_x64.msi /passive /norestart/passive参数表示只显示进度条不弹交互窗口适合批量部署。安装过程很短暂一般30秒内完成。安装完成后怎么确认内核生效呢在PowerShell里运行wsl --status如果看到“默认版本: 2”以及关于WSL2内核的提示说明内核安装成功。旧版wsl.exe没有--status命令时可以直接尝试导入一个发行版跑起来正常就说明没问题。这里要说明一下wsl_update_x64.msi安装的是WSL2的内核文件。如果你的Windows版本较新wsl.exe可能会优先使用商店版WSL组件发现内核版本旧时还会尝试联网更新。离线条件下如果你不打算让wsl.exe联网可以保持默认设置不动只要内核能跑起来就没问题。后面第6节我会专门讲怎么避免“update卡住”。4.3 将WSL2设置为默认版本接下来设置WSL2作为默认架构。在管理员PowerShell中执行wsl --set-default-version 2这一步的目的是让之后安装或导入的发行版默认以WSL2模式运行。有些机器之前装过WSL1这条命令可以把新的发行版强制切成WSL2。如果命令执行后提示“安装适用于 Linux 的 Windows 子系统内核”说明内核更新包没有装好或者wsl.exe要找商店版内核。此时回到第4.2步确认MSI安装是否成功。如果想单独指定某个发行版用WSL2可以执行wsl --set-version 发行版名称 2这个命令会在目标发行版上执行WSL1到WSL2的转换。但在离线环境里要特别注意转换过程需要访问WSL2内核如果内核缺失或版本不对会失败。4.4 通过Add-AppxPackage安装Ubuntu 22.04如果你准备的是.appx格式的发行版包离线安装非常简单。管理员身份打开PowerShell进入文件所在目录执行Add-AppxPackage .\Ubuntu_2204.1.7.1_x64.appx安装完成后开始菜单里会出现“Ubuntu”图标点开即可进入首次初始化流程设置用户名和密码。这个流程不需要联网初始化脚本只在本地创建用户。但很多人在这一步会遇到问题结果双击Ubuntu直接闪退或者提示“WSL注册分发失败”。这通常是因为WSL组件没完全启用或者内核没装好。可以先重启再确认第4.1和4.2步都完成。如果使用Add-AppxPackage安装的是msixbundle也可能需要先从bundle里提取适合当前架构的appx再进行安装不过大部分教程路径我都试过最简单是直接用aka.ms链接下载x64的appx。4.5 通过wsl --import导入tar镜像离线推荐wsl --import是我在离线环境里最常用的方式因为不依赖商店组件对WSL组件版本要求也低。操作步骤如下创建一个存放发行版文件的目录。比如D:\WSL\Ubuntu2204。把准备好的tar或tar.gz文件放到目录旁边。管理员PowerShell执行wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 .\ubuntu-22.04-wsl-amd64-xxx.tar --version 2注意如果下载的文件是.tar.gz有的wsl.exe版本直接支持不支持的话先用7-Zip解压一次解出.tar再导入。导入成功后查看发行版列表wsl --list --verbose看到NAME / STATE / VERSION列表里Ubuntu-22.04后面写2就说明导入成了WSL2发行版。进入系统wsl -d Ubuntu-22.04首次进入默认是root用户因为tar包没有默认用户配置。接下来需要手动创建用户并设置默认用户这部分我在第5节详细讲。对比两种方式Add-AppxPackage更接近普通用户的使用习惯而wsl --import更灵活可以精确控制发行版的位置而且完全绕开商店组件。所以我的实践结论是离线环境优先走tar导入除非客户要求必须用商店安装方式。5. 离线安装后必须做的三件事5.1 修改默认用户和wsl.conf用wsl --import导入的发行版默认用户是root这对后续开发和日常使用不太方便因为所有文件都归root所有VS Code连上去写代码还要频繁处理权限问题。我的做法是在发行版里创建普通用户再通过/etc/wsl.conf指定默认用户。具体命令useradd -m -s /bin/bash dev passwd dev然后编辑/etc/wsl.conf[user] defaultdev保存后在Windows端执行wsl --shutdown再重新进入wsl -d Ubuntu-22.04就会直接切换到dev用户。如果还想让systemd跑起来比如要使用systemctl管理服务需要在/etc/wsl.conf里加[boot] systemdtrue前提是WSL版本支持systemd。离线环境中如果内核版本较旧可能不支持建议在联网机器上提前把WSL升级到2.0以上再导出tar这样离线导入的新系统也能支持systemd。5.2 更改发行版目录别让C盘爆掉很多人装完WSL2后发现C盘空间掉得飞快因为默认发行版放在C:\Users\用户名\AppData\Local\Packages\下面。离线安装时如果一开始就打算放到其他盘直接用wsl --import到D盘或E盘是最好的。如果发行版已经装在默认位置想迁移可以用导出再导入的方式wsl --export Ubuntu-22.04 D:\backup\ubuntu2204.tar wsl --unregister Ubuntu-22.04 wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\backup\ubuntu2204.tar --version 2注意--unregister会删除原发行版所有数据导出再导入前务必确认数据已经包含在tar中。这个操作还能顺便压缩磁盘碎片有时候导出的tar比实际占用小很多。新版本WSL支持wsl --manage 发行版 --move 新路径有这条命令的话操作更方便但离线环境下老版本不一定有我通常会准备导出导入这个保守方案。5.3 配置内网apt源解决“装不了软件”的问题离线机器的网络受限Ubuntu默认的archive.ubuntu.com源肯定访问不了运行apt update会报一堆连接错误。解决办法是在/etc/apt/sources.list中把源改成内网镜像地址。如果内网有Ubuntu镜像服务可以直接替换deb http://192.168.x.x/ubuntu/ jammy main restricted universe multiverse deb http://192.168.x.x/ubuntu/ jammy-updates main restricted universe multiverse如果没有内网源就只能在联网机器上批量下载deb包然后拷贝进去安装。举一个例子离线安装Node.js联网机器上执行apt-get download nodejs npm。把下载的.deb文件拷贝到目标机器任意目录。目标机器进入目录后执行dpkg -i *.deb。这里需要注意依赖问题。.deb包之间会有依赖关系最可靠的是在联网机器上用apt-cache depends逐个分析或者用apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks nodejs | grep ^\w | sort -u)一次性抓取全部依赖。过程比较繁琐但比现场卡在内网源折腾要强多了。6. 我踩过的坑问题排查记录6.1 错误“无法启动因为此计算机上未启用虚拟化”这是热词里最常见的一条。命令打印出来的意思是WSL2需要虚拟化支持但在当前机器上没找到。排查步骤我总结为三步检查BIOS设置确认Intel VT-x或AMD SVM已经开启。检查Windows功能确认VirtualMachinePlatform已经启用。检查Hypervisor是否开启执行bcdedit /enum {current}看hypervisorlaunchtype是否是Auto。如果以上都没问题还有可能被“内核隔离-内存完整性”干扰。在Windows安全中心的“设备安全性-内核隔离”里暂时关闭内存完整性重启后一般能解决。这里有个特别坑的机器厂商固件在系统启动后才打开CPU虚拟化Windows检测不到必须进BIOS彻底禁用再启用一次或者更新BIOS版本。6.2 wsl --update卡住或慢到怀疑人生很多人装了旧版WSL后执行wsl --update卡在0%半天不动最后超时失败。原因很简单wsl.exe默认从微软服务器在线下载最新的WSL应用包而离线或弱网环境根本无法完成下载。我的处理办法是绕开在线更新如果目标机器是Windows 10 2004/21H2用wsl_update_x64.msi手动安装WSL2内核。系统自带的wsl.exe配合这个MSI足够支撑基本的WSL2运行。如果目标机器是Windows 11系统会倾向于使用Microsoft Store发布的WSL应用。离线环境下可以下载官方的Windows Subsystem for Linux离线包.msixbundle然后通过PowerShellAdd-AppxPackage安装。这类离线包可以从微软商店的网页端获取。最省事的做法不要在新版本Windows上执念于商店版WSL而是使用系统自带的旧wsl.exe只要满足日常命令就不去管更新提示。说白了离线环境的核心策略是“不上最新能跑就行”。WSL2又不是非要天天更新稳定跑起来才是硬道理。6.3 Add-AppxPackage装完启动不了的排查用Add-AppxPackage装完Ubuntu后双击启动提示“安装失败错误代码0x8007007e”或者直接闪退多数情况是底层功能没开齐。我排查顺序是确认WSL和虚拟机平台两个功能都在启用状态。确认内核MSI安装过wsl --status能正常输出。确认目标机器支持虚拟化并已在BIOS开启。如果都正常可以试试在PowerShell里直接启动ubuntu2204.exe这样能在终端窗口看到具体报错比闪退时的一闪而过有用得多。6.4 离线导入的发行版无法启动或没有权限wsl --import导入的tar包如果是从云镜像下载的rootfs可能缺少WSL的初始化文件启动后出现“安装已中止”或卡在黑屏。这种情况我一般改用在线机器wsl --export导出的tar包因为这种导出包含WSL运行时的所有元数据兼容性更好。启动后如果发现用户权限混乱可以在Windows侧进入发行版直接编辑配置wsl -d Ubuntu-22.04 -u root然后用第5.1节的方式修复。注意wsl --import后默认用户是root这个不是我乱说是实际测试的结果。6.5 独家经验离线包版本要与Windows版本匹配这是我最想强调的一点。WSL2的内核MSI和Windows版本是有关联的。如果你的Windows 10还是21H2装最新的WSL2内核MSI通常没问题因为微软做了向后兼容。但如果你在Windows 11上装了很老的wsl_update_x64.msi可能会出现内核版本太低导致发行版无法以WSL2模式运行。我的习惯是在联网机器上先把WSL跑通用wsl --version看到具体版本号再去下载对应版本的内核包尽量保证离线环境使用的包和我在联网机器上验证过的版本完全一致。另外离线安装过程中最容易被忽略的是Windows更新组件本身。有些精简版系统会把VirtualMachinePlatform功能的源文件删掉DISM启用时直接报错“0x800f081f”。这时候没有别的办法只能从同版本完整镜像中获取组件或者换一个原版系统。所以我在准备离线安装材料时一定会先要目标机器系统的具体版本号winver命令能看到再确认功能组件是否完整。最后再分享一个实操习惯我会在随身U盘里建立一个固定结构的离线工具包叫wsl-offline里面放好WSL内核MSI、Ubuntu 22.04的appx和tar.gz、Miniconda安装脚本、常用deb包。每次接新项目先核对目标机的Windows版本和架构再补充相应的离线包。这套材料已经帮我搞定了无数次内网环境下的Linux环境搭建也希望你看完能直接用起来少走我当初那些弯路。
WSL2这个东西用过就回不去了。但真正麻烦的不是它好不好用而是怎么在一台断网的机器上把它装起来。我遇到过不止一次生产内网机器、客户机房、甚至家里那台老笔记本系统是Windows 10 21H2网络要么没有要么慢到wsl --update卡在0%半天不动。这时候如果手边没有一套现成的离线安装包就只能干瞪眼。这篇文章就把我这两三年反复折腾WSL2离线安装的经验写出来从环境检查、文件准备、功能开启、内核安装、发行版导入到常见坑一条龙讲清楚。看完你也能在完全没外网的环境下把WSL2稳稳当当用起来。1. 为什么我要折腾离线安装WSL21.1 WSL2是什么离线安装和非离线有什么不同WSL2的全称是Windows Subsystem for Linux 2是微软在Windows 10 2004版本之后推出的第二代Linux子系统。它和第一代WSL1最大的区别是使用了真正的Linux内核通过轻量级虚拟机的方式运行而不是像WSL1那样做一层的系统调用翻译。这样一来绝大多数Linux二进制程序都能原生跑Docker、CUDA、TensorFlow这些重工具在WSL2里的表现和真实Linux机器差距很小。我平时写后端、跑人工智能模型、处理数据都直接在WSL2里干Windows这边只负责编辑器、浏览器和日常通讯舒适度很高。在线安装WSL2很简单打开PowerShell执行wsl --install它会自动帮你开功能、装内核、装发行版一路顺畅。但离线环境就麻烦了。离线意味着Windows更新连不上应用商店连不上甚至微软的下载服务器也连不上。而WSL2的安装流程偏偏依赖这些在线资源需要下载WSL内核更新包需要下载Ubuntu这类发行版镜像有时还需要升级wsl.exe本身。离线安装要做的事情本质上就是把这些本来需要在线获取的东西提前下载好带到目标机器上手动装。1.2 适合离线安装的真实场景我整理了一下离线安装WSL2主要出现在下面几类场景企业内网和隔离网环境。很多公司的研发网和生产网严格隔离机器不允许接入互联网。开发者想在本地用Linux工具链只能在内网环境中安装WSL2。机房批量交付。给客户交付一批Windows服务器要求预装好WSL2和指定Ubuntu版本。这些机器在交付前可能没有接入外网或者网速极不稳定批量配置时离线安装反而更可控。老旧笔记本或临时设备。有的旧电脑升级到Win10后无线网卡驱动有问题或者网络下载速度感人在线安装WSL2基本等不起。企业安全策略限制。部分安全软件会拦截系统组件在线安装但允许管理员手动执行安装包。这些场景的共同点是“网络不可靠或不可用”但用户对WSL2的需求又是刚需。离线安装就成了唯一的出路。1.3 离线安装的整体思路离线安装WSL2并不神秘核心思路就是四个字提前囤货。我们需要准备四样东西Windows必选功能Microsoft-Windows-Subsystem-LinuxWSL功能和VirtualMachinePlatform虚拟机平台。这两个功能在Windows系统镜像自带的组件里离线机器也能通过DISM命令开启。WSL2内核更新包微软官方提供的MSI安装包文件名类似wsl_update_x64.msi。这个包负责把WSL2需要的Linux内核安装到Windows上。Linux发行版离线包可以是微软商店的.appx格式也可以是从已有WSL导出的.tar格式或者是云镜像平台提供的rootfs压缩包。一个能用的wsl.exe。新版Windows自带的wsl.exe已经支持wsl --install但离线机器如果版本低老一点的内核配合手动安装的MSI也够用。把这几样准备齐了离线的安装流程就是开功能、重启、装内核、导入发行版。下面的内容我会按这个流程一步步拆开讲。2. 先查环境别急着下载安装包2.1 Windows系统版本和硬件要求离线安装之前第一步永远是确认目标机器的Windows版本和芯片支持情况。WSL2有硬性要求不是随便一台Win10都能装。项目要求Windows 10版本2004Build 19041及以上或Windows 11Windows Server2019 / 2022需要安装相应功能CPU支持虚拟化需要开启VT-xIntel或AMD-VAMD且在BIOS/UEFI中启用内存建议至少4GB跑编译任务推荐8GB以上硬盘至少20GB可用空间如果装多个发行版建议更多如果机器是Windows 10 1909或更早版本那只能装WSL1装不了WSL2。这种情况要么升级系统要么放弃WSL2改用其他方案。在给客户交付时我最怕的就是现场发现系统版本不够所以动手前我会先拿到系统信息再准备材料。2.2 虚拟化是否开启三条命令判断WSL2是用Hyper-V虚拟化技术跑的CPU虚拟化没开一切白搭。判断方法很简单管理员权限打开PowerShell或CMD运行systeminfo在输出信息的最下方找到“Hyper-V 要求”部分。如果看到“已在固件中启用虚拟化: 是”说明CPU虚拟化已经打开。如果显示“否”就需要进BIOS/UEFI开启Intel Virtualization Technology或AMD SVM Mode然后重启。也可以运行msinfo32打开系统信息窗口在“系统摘要”里找“基于虚拟化的安全性”和“虚拟化固件中已启用”这两个条目。还有一条命令可以查Hypervisor是否已经在运行bcdedit /enum {current} | find hypervisorlaunchtype如果输出hypervisorlaunchtype Auto说明Hyper-V已经处于启动状态。如果输出OffWSL2的虚拟机平台可能没跑起来。这里有个容易踩的坑有些机器的CPU虚拟化在BIOS里明明开了但Windows里还是显示“未启用”。这往往是因为启用了“基于虚拟化的安全性”VBS或“内核隔离-内存完整性”导致Hypervisor被占用或冲突。遇到这种情况我一般先看msinfo32里的“基于虚拟化的安全性”是否显示“正在运行”如果是可以把“内核隔离”临时关掉再测试。2.3 目标机上的可选功能状态开启WSL2需要两个Windows可选功能Microsoft-Windows-Subsystem-Linux和VirtualMachinePlatform。在离线机器上可以用DISM命令直接查询哪些功能是由系统镜像自带的dism.exe /online /get-feature /format:table | findstr Subsystem VirtualMachinePlatform正常情况下会看到两个功能的名称以及“启用/禁用”状态。如果功能在系统映像中存在那么即便离线也能安装。如果查不到就需要检查系统版本或系统镜像是否完整。这一步很重要因为有些精简版Windows为了减少体积把可选功能组件裁剪掉了。真遇到这种情况离线安装就会失败只能换一个完整版系统或重新安装官方原版镜像。3. 在联网机器上准备离线安装材料3.1 WSL2内核更新包怎么下载最核心的文件是WSL2 Linux内核更新包。微软官方下载地址是https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package页面上提供wsl_update_x64.msi64位版和ARM64版。绝大多数机器选择x64版。下载完成后建议用PowerShell校验一下哈希防止文件损坏Get-FileHash .\wsl_update_x64.msi -Algorithm SHA256然后把MSI文件拷到U盘或内网共享目录。这个MSI包就是离线安装WSL2内核的关键它能在完全无网的情况下完成内核安装这个环节。如果你在目标机上用的是新版WSL通过Microsoft Store发布的版本它还会自动更新内核。但在离线环境下商店连不上所以最稳妥的做法是安装完MSI后不要让wsl.exe强制去商店更新或者使用带--web-download参数的旧版命令时保持谨慎。后面我会专门讲“wsl --update卡住”这个坑。3.2 Linux发行版离线包appx和tar两种选择离线安装Linux发行版我习惯准备两种格式根据目标机器情况灵活选择。第一种是微软商店包也就是.appx或.msixbundle。你可以从微软商店的“网页版”链接直接下载。以Ubuntu 22.04 LTS为例官方下载地址是https://aka.ms/wslubuntu2204下载下来通常是一个Ubuntu_2204.1.7.1_x64.appx文件或者是一个带.msixbundle后缀的多架构包。之后在目标机器上通过PowerShell命令Add-AppxPackage安装相当于手动完成商店安装动作。第二种是.tar格式的rootfs或发行版导出包。这种格式更通用适合离线导入。获取方式有两种从一台已经装好WSL2的机器上导出wsl --export 发行版名称 ubuntu2204.tar从Ubuntu云镜像网站下载官方WSL rootfs压缩包https://cloud-images.ubuntu.com/wsl/目录下有类似ubuntu-22.04-wsl-amd64-...tar.gz的文件。我推荐同时准备这两种格式。appx适合走标准商店安装流程tar格式配合wsl --import更灵活还能直接放到非C盘目录。3.3 准备辅助工具和软件源除了WSL2本身如果你还想在离线机器上装Python、Node.js、Docker等就需要顺便把软件安装包也准备好。我常做的准备有下载Miniconda离线安装脚本、Node.js官方二进制包或者各种deb包。如果内网有Linux软件源镜像把源地址记录下来安装完系统后配置到/etc/apt/sources.list。如果内网没有软件源可以用apt-get download在联网机器上把依赖包批量下载下来再拷进去用apt-get install ./*.deb安装。别小看这些准备工作很多时候WSL2装好了结果用户发现里面连gcc都没有还得折腾内网源体验就很差。离线部署讲究“一套材料到位”提前多花十分钟现场能省两小时。4. 目标机离线安装全流程4.1 用DISM开启WSL和虚拟机平台功能在目标机器上以管理员身份打开PowerShell或CMD执行两条命令dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart第一条命令开启WSL基本功能第二条开启虚拟机平台。这两步都是使用本地系统镜像完成不需要联网。/all参数表示同时启用所有父级功能/norestart表示暂时不重启。执行完后需要重启系统让功能生效。这里我一般不会用/norestart参数直接让DISM返回后手动重启确保一切干净。重启后可以用查询命令确认dism.exe /online /get-feature /format:table | findstr Subsystem VirtualMachinePlatform这时两个功能应该显示为“启用”。4.2 安装WSL2内核更新包重启完成后把提前准备好的wsl_update_x64.msi拷到目标机器双击运行或者在管理员PowerShell中执行msiexec.exe /i .\wsl_update_x64.msi /passive /norestart/passive参数表示只显示进度条不弹交互窗口适合批量部署。安装过程很短暂一般30秒内完成。安装完成后怎么确认内核生效呢在PowerShell里运行wsl --status如果看到“默认版本: 2”以及关于WSL2内核的提示说明内核安装成功。旧版wsl.exe没有--status命令时可以直接尝试导入一个发行版跑起来正常就说明没问题。这里要说明一下wsl_update_x64.msi安装的是WSL2的内核文件。如果你的Windows版本较新wsl.exe可能会优先使用商店版WSL组件发现内核版本旧时还会尝试联网更新。离线条件下如果你不打算让wsl.exe联网可以保持默认设置不动只要内核能跑起来就没问题。后面第6节我会专门讲怎么避免“update卡住”。4.3 将WSL2设置为默认版本接下来设置WSL2作为默认架构。在管理员PowerShell中执行wsl --set-default-version 2这一步的目的是让之后安装或导入的发行版默认以WSL2模式运行。有些机器之前装过WSL1这条命令可以把新的发行版强制切成WSL2。如果命令执行后提示“安装适用于 Linux 的 Windows 子系统内核”说明内核更新包没有装好或者wsl.exe要找商店版内核。此时回到第4.2步确认MSI安装是否成功。如果想单独指定某个发行版用WSL2可以执行wsl --set-version 发行版名称 2这个命令会在目标发行版上执行WSL1到WSL2的转换。但在离线环境里要特别注意转换过程需要访问WSL2内核如果内核缺失或版本不对会失败。4.4 通过Add-AppxPackage安装Ubuntu 22.04如果你准备的是.appx格式的发行版包离线安装非常简单。管理员身份打开PowerShell进入文件所在目录执行Add-AppxPackage .\Ubuntu_2204.1.7.1_x64.appx安装完成后开始菜单里会出现“Ubuntu”图标点开即可进入首次初始化流程设置用户名和密码。这个流程不需要联网初始化脚本只在本地创建用户。但很多人在这一步会遇到问题结果双击Ubuntu直接闪退或者提示“WSL注册分发失败”。这通常是因为WSL组件没完全启用或者内核没装好。可以先重启再确认第4.1和4.2步都完成。如果使用Add-AppxPackage安装的是msixbundle也可能需要先从bundle里提取适合当前架构的appx再进行安装不过大部分教程路径我都试过最简单是直接用aka.ms链接下载x64的appx。4.5 通过wsl --import导入tar镜像离线推荐wsl --import是我在离线环境里最常用的方式因为不依赖商店组件对WSL组件版本要求也低。操作步骤如下创建一个存放发行版文件的目录。比如D:\WSL\Ubuntu2204。把准备好的tar或tar.gz文件放到目录旁边。管理员PowerShell执行wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 .\ubuntu-22.04-wsl-amd64-xxx.tar --version 2注意如果下载的文件是.tar.gz有的wsl.exe版本直接支持不支持的话先用7-Zip解压一次解出.tar再导入。导入成功后查看发行版列表wsl --list --verbose看到NAME / STATE / VERSION列表里Ubuntu-22.04后面写2就说明导入成了WSL2发行版。进入系统wsl -d Ubuntu-22.04首次进入默认是root用户因为tar包没有默认用户配置。接下来需要手动创建用户并设置默认用户这部分我在第5节详细讲。对比两种方式Add-AppxPackage更接近普通用户的使用习惯而wsl --import更灵活可以精确控制发行版的位置而且完全绕开商店组件。所以我的实践结论是离线环境优先走tar导入除非客户要求必须用商店安装方式。5. 离线安装后必须做的三件事5.1 修改默认用户和wsl.conf用wsl --import导入的发行版默认用户是root这对后续开发和日常使用不太方便因为所有文件都归root所有VS Code连上去写代码还要频繁处理权限问题。我的做法是在发行版里创建普通用户再通过/etc/wsl.conf指定默认用户。具体命令useradd -m -s /bin/bash dev passwd dev然后编辑/etc/wsl.conf[user] defaultdev保存后在Windows端执行wsl --shutdown再重新进入wsl -d Ubuntu-22.04就会直接切换到dev用户。如果还想让systemd跑起来比如要使用systemctl管理服务需要在/etc/wsl.conf里加[boot] systemdtrue前提是WSL版本支持systemd。离线环境中如果内核版本较旧可能不支持建议在联网机器上提前把WSL升级到2.0以上再导出tar这样离线导入的新系统也能支持systemd。5.2 更改发行版目录别让C盘爆掉很多人装完WSL2后发现C盘空间掉得飞快因为默认发行版放在C:\Users\用户名\AppData\Local\Packages\下面。离线安装时如果一开始就打算放到其他盘直接用wsl --import到D盘或E盘是最好的。如果发行版已经装在默认位置想迁移可以用导出再导入的方式wsl --export Ubuntu-22.04 D:\backup\ubuntu2204.tar wsl --unregister Ubuntu-22.04 wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\backup\ubuntu2204.tar --version 2注意--unregister会删除原发行版所有数据导出再导入前务必确认数据已经包含在tar中。这个操作还能顺便压缩磁盘碎片有时候导出的tar比实际占用小很多。新版本WSL支持wsl --manage 发行版 --move 新路径有这条命令的话操作更方便但离线环境下老版本不一定有我通常会准备导出导入这个保守方案。5.3 配置内网apt源解决“装不了软件”的问题离线机器的网络受限Ubuntu默认的archive.ubuntu.com源肯定访问不了运行apt update会报一堆连接错误。解决办法是在/etc/apt/sources.list中把源改成内网镜像地址。如果内网有Ubuntu镜像服务可以直接替换deb http://192.168.x.x/ubuntu/ jammy main restricted universe multiverse deb http://192.168.x.x/ubuntu/ jammy-updates main restricted universe multiverse如果没有内网源就只能在联网机器上批量下载deb包然后拷贝进去安装。举一个例子离线安装Node.js联网机器上执行apt-get download nodejs npm。把下载的.deb文件拷贝到目标机器任意目录。目标机器进入目录后执行dpkg -i *.deb。这里需要注意依赖问题。.deb包之间会有依赖关系最可靠的是在联网机器上用apt-cache depends逐个分析或者用apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks nodejs | grep ^\w | sort -u)一次性抓取全部依赖。过程比较繁琐但比现场卡在内网源折腾要强多了。6. 我踩过的坑问题排查记录6.1 错误“无法启动因为此计算机上未启用虚拟化”这是热词里最常见的一条。命令打印出来的意思是WSL2需要虚拟化支持但在当前机器上没找到。排查步骤我总结为三步检查BIOS设置确认Intel VT-x或AMD SVM已经开启。检查Windows功能确认VirtualMachinePlatform已经启用。检查Hypervisor是否开启执行bcdedit /enum {current}看hypervisorlaunchtype是否是Auto。如果以上都没问题还有可能被“内核隔离-内存完整性”干扰。在Windows安全中心的“设备安全性-内核隔离”里暂时关闭内存完整性重启后一般能解决。这里有个特别坑的机器厂商固件在系统启动后才打开CPU虚拟化Windows检测不到必须进BIOS彻底禁用再启用一次或者更新BIOS版本。6.2 wsl --update卡住或慢到怀疑人生很多人装了旧版WSL后执行wsl --update卡在0%半天不动最后超时失败。原因很简单wsl.exe默认从微软服务器在线下载最新的WSL应用包而离线或弱网环境根本无法完成下载。我的处理办法是绕开在线更新如果目标机器是Windows 10 2004/21H2用wsl_update_x64.msi手动安装WSL2内核。系统自带的wsl.exe配合这个MSI足够支撑基本的WSL2运行。如果目标机器是Windows 11系统会倾向于使用Microsoft Store发布的WSL应用。离线环境下可以下载官方的Windows Subsystem for Linux离线包.msixbundle然后通过PowerShellAdd-AppxPackage安装。这类离线包可以从微软商店的网页端获取。最省事的做法不要在新版本Windows上执念于商店版WSL而是使用系统自带的旧wsl.exe只要满足日常命令就不去管更新提示。说白了离线环境的核心策略是“不上最新能跑就行”。WSL2又不是非要天天更新稳定跑起来才是硬道理。6.3 Add-AppxPackage装完启动不了的排查用Add-AppxPackage装完Ubuntu后双击启动提示“安装失败错误代码0x8007007e”或者直接闪退多数情况是底层功能没开齐。我排查顺序是确认WSL和虚拟机平台两个功能都在启用状态。确认内核MSI安装过wsl --status能正常输出。确认目标机器支持虚拟化并已在BIOS开启。如果都正常可以试试在PowerShell里直接启动ubuntu2204.exe这样能在终端窗口看到具体报错比闪退时的一闪而过有用得多。6.4 离线导入的发行版无法启动或没有权限wsl --import导入的tar包如果是从云镜像下载的rootfs可能缺少WSL的初始化文件启动后出现“安装已中止”或卡在黑屏。这种情况我一般改用在线机器wsl --export导出的tar包因为这种导出包含WSL运行时的所有元数据兼容性更好。启动后如果发现用户权限混乱可以在Windows侧进入发行版直接编辑配置wsl -d Ubuntu-22.04 -u root然后用第5.1节的方式修复。注意wsl --import后默认用户是root这个不是我乱说是实际测试的结果。6.5 独家经验离线包版本要与Windows版本匹配这是我最想强调的一点。WSL2的内核MSI和Windows版本是有关联的。如果你的Windows 10还是21H2装最新的WSL2内核MSI通常没问题因为微软做了向后兼容。但如果你在Windows 11上装了很老的wsl_update_x64.msi可能会出现内核版本太低导致发行版无法以WSL2模式运行。我的习惯是在联网机器上先把WSL跑通用wsl --version看到具体版本号再去下载对应版本的内核包尽量保证离线环境使用的包和我在联网机器上验证过的版本完全一致。另外离线安装过程中最容易被忽略的是Windows更新组件本身。有些精简版系统会把VirtualMachinePlatform功能的源文件删掉DISM启用时直接报错“0x800f081f”。这时候没有别的办法只能从同版本完整镜像中获取组件或者换一个原版系统。所以我在准备离线安装材料时一定会先要目标机器系统的具体版本号winver命令能看到再确认功能组件是否完整。最后再分享一个实操习惯我会在随身U盘里建立一个固定结构的离线工具包叫wsl-offline里面放好WSL内核MSI、Ubuntu 22.04的appx和tar.gz、Miniconda安装脚本、常用deb包。每次接新项目先核对目标机的Windows版本和架构再补充相应的离线包。这套材料已经帮我搞定了无数次内网环境下的Linux环境搭建也希望你看完能直接用起来少走我当初那些弯路。
