在CMD中使用wsl --install一键安装 WSL 时遇到“与服务器的连接被重置”或中途断开99%的原因是因为国内网络连接微软官方服务器或 GitHub不稳定导致下载内核或Linux发行版时超时断开。要彻底解决这个问题最推荐的方法是放弃一键命令改为“手动离线安装”。以下是具体的操作步骤 安装决策流程图当wsl --install一键安装失败时可以参考以下决策流程选择解决方案是是否否一键安装失败连接被重置/超时是否继续尝试一键安装方法二优化网络环境1. 为CMD配置代理2. 更改DNS服务器再次尝试wsl --install是否成功✅ 安装完成转入手动离线安装方法一手动离线安装推荐成功率100%第1步启用Windows必备功能- 启用WSL功能- 启用虚拟机平台- 重启电脑第2步下载并安装WSL2内核- 访问官方链接下载内核包- 双击安装wsl_update_x64.msi第3步设置WSL2为默认版本- 管理员CMD运行wsl --set-default-version 2第4步安装Linux发行版- 方式A微软商店安装Ubuntu- 方式B下载离线包安装✅ 安装完成设置用户名密码即可使用流程图说明起点一键安装失败连接被重置/超时决策点是否继续尝试一键安装是→ 使用方法二优化网络环境后重试否→ 直接采用方法一手动离线安装方法一流程四个清晰步骤启用功能→下载内核→设置版本→安装发行版方法二流程优化网络后重试若仍失败则转入手动安装方法一手动离线安装最推荐成功率 100%通过浏览器或下载工具手动下载所需组件绕过 CMD 不稳定的网络下载机制。第 1 步启用 Windows 必备功能按Win S搜索cmd右键选择“以管理员身份运行”。依次复制并运行以下两条命令启用 WSL 和虚拟机平台dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart重启电脑这一步必须做否则后续步骤会报错。第 2 步手动下载并安装 WSL 2 内核更新包重启后使用浏览器如Edge/Chrome访问微软官方内核下载链接 https://aka.ms/wsl2kernel)(如果链接跳转慢可直接复制此直链下载https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi)下载完成后双击运行wsl_update_x64.msi进行安第 3 步设置 WSL 2 为默认版本打开管理员 CMD输入以下命令并回车wsl --set-default-version 2(如果提示请将……启用为默认版本请检查第 1 步的功能是否开启并重启了电脑)第 4 步手动下载并安装 Linux 发行版如 Ubuntu不要使用wsl --install下载了直接去微软商店或下载离线包方式 A推荐打开电脑自带的Microsoft Store微软商店搜索Ubuntu推荐 Ubuntu 22.04 或 24.04点击获取/安装。方式 B离线包如果微软商店也连不上可以用浏览器下载离线安装包Ubuntu 24.04https://aka.ms/wslubuntu2404Ubuntu 22.04https://aka.ms/wslubuntu2204下载后得到的是一个.appx或.appxbundle文件直接双击它即可安装。安装完成后在开始菜单找到 Ubuntu 并打开设置用户名和密码即可。常见手动安装问题排查手动安装过程中可能会遇到以下问题这里提供相应的排查方案问题现象可能原因解决方案双击 MSI 无反应1. 系统权限不足2. 文件损坏3. 安全软件拦截1.右键以管理员身份运行2. 重新下载内核包检查文件完整性3. 临时关闭杀毒软件/防火墙再试安装发行版时报错0x80070005权限不足或文件被占用1. 确保使用管理员权限运行安装程序2. 关闭所有可能占用系统文件的程序如虚拟机软件3. 尝试在安全模式下安装商店下载慢或无法连接微软商店服务器网络不稳定1. 使用**方式 B离线包**直接下载安装2. 更换网络环境如使用手机热点3. 修改系统 DNS 为8.8.8.8和8.8.4.4运行wsl --set-default-version 2提示请启用 WSL第 1 步的功能未正确启用或未重启1. 确认已以管理员身份运行两条dism.exe命令2.必须重启电脑后重试此命令3. 在启用或关闭 Windows 功能中手动勾选适用于 Linux 的 Windows 子系统和虚拟机平台安装后 Ubuntu 启动闪退1. WSL 2 内核未正确安装2. 虚拟化未开启1. 重新运行第 2 步的 MSI 安装包2. 进入 BIOS 开启Virtualization Technology (VT-x/AMD-V)3. 在 PowerShell 中运行wsl --update更新内核离线包.appx安装失败系统版本过低或架构不匹配1. 确认 Windows 版本 ≥ 1903x642. 下载与系统架构匹配的包通常为 x643. 尝试通过微软商店安装方式 A安装后无法设置用户名密码系统区域设置或用户名冲突1. 确保系统区域设置为中文简体中国2. 使用纯英文用户名不含空格和特殊字符3. 在 PowerShell 中运行wsl --unregister 发行版名后重新安装如果以上方案仍无法解决您的问题建议查阅 WSL 官方文档 或社区论坛寻求帮助。方法二优化网络环境后重试备用方案如果由于环境限制必须使用wsl --install命令可以尝试以下通用网络优化方法改善与微软服务器的连接稳定性。1. 更改 DNS 服务器首选方案不稳定的 DNS 解析是导致“连接被重置”的常见原因。将 DNS 修改为公共 DNS 可能解决问题打开控制面板-网络和共享中心- 点击你正在使用的网络连接如 WLAN 或 以太网。点击属性- 双击Internet 协议版本 4 (TCP/IPv4)。选择“使用下面的 DNS 服务器地址”并填入首选 DNS 服务器8.8.8.8(Google Public DNS)备用 DNS 服务器8.8.4.4或114.114.114.114(国内备用)点击“确定”保存设置。以管理员身份打开CMD或PowerShell运行以下命令刷新 DNS 缓存ipconfig /flushdns关闭所有 CMD/PowerShell 窗口重新打开一个新的管理员 CMD再次尝试运行wsl --install。2. 使用稳定的网络连接尝试切换网络如果可能连接手机热点或其他网络环境进行尝试。避开高峰时段在网络使用低峰期例如深夜或清晨进行安装。暂时关闭防火墙/安全软件某些安全软件的流量扫描可能会干扰长时间连接。可尝试暂时关闭后再试操作后请记得重新开启。重要提示如果上述优化后wsl --install仍然失败强烈建议您转而采用【方法一手动离线安装】这是成功率最高、最不受网络波动影响的方式。 补充排错提示BIOS 虚拟化未开启如果安装过程中提示虚拟机平台无法启用或者报错0x80370102请重启电脑进入 BIOS找到 Virtualization Technology (VT-x/AMD-V) 并将其设置为 Enabled开启。Windows 版本过低WSL 2 需要 Windows 10 版本 1903 (x64) 或更高版本推荐直接升级到 Windows 10 22H2 或 Windows 11 以获得最佳体验。✅ 验证安装成功安装完成后请按照以下步骤验证 WSL 2 内核和 Linux 发行版是否已正确安装并运行打开 Ubuntu 终端在 Windows 开始菜单中搜索并打开你安装的Ubuntu例如 “Ubuntu 24.04”。首次打开会提示你设置用户名和密码密码输入时不会显示输入后按回车即可。验证 WSL 版本和运行状态回到Windows 命令提示符CMD或 PowerShell管理员或非管理员均可。运行以下命令查看已安装的 WSL 发行版及其版本和状态wsl --list --verbose预期输出示例NAME STATE VERSION * Ubuntu-24.04 Running 2STATE为Running表示正在运行Stopped表示已停止。VERSION为2表示正在使用 WSL 2 内核。验证 Linux 内核版本在Ubuntu 终端中运行以下命令uname-a预期输出示例Linux DESKTOP-XXXXXX 5.15.133.1-microsoft-standard-WSL2 #1 SMP ... x86_64 x86_64 x86_64 GNU/Linux输出中包含WSL2字样即表示正在使用 WSL 2 内核。验证通过标志wsl --list --verbose显示发行版版本为2。uname -a输出中包含WSL2。可以在 Ubuntu 终端中正常使用 Linux 命令如ls,pwd。如果验证失败请检查上述安装步骤是否全部完成或参考前面的排错提示。