[智能体-568]：Win10 22H2 WSL2 官方在线安装全过程（含国内网络超时完整修复）

一、前置硬性条件（必须全部满足）

  1. 系统版本：Win10 22H2（内部版本 19045 ≥ 19041，支持一键wsl --install）
  2. 硬件虚拟化：重启进 BIOS 开启 CPU 虚拟化（Intel VT-x / AMD-V） 验证：任务管理器 → 性能 → CPU，查看「虚拟化：已启用」
  3. 权限：所有命令必须右键以管理员身份打开 PowerShell 执行
  4. 磁盘：C 盘预留 ≥10GB 空闲空间
  5. 网络预处理：临时关闭 VPN、代理、加速器、防火墙 / 安全软件

阶段 1：启用 WSL 两大系统底层组件（二选一操作）

方式 A：图形界面（你已有的截图界面）

  1. Win+R输入optionalfeatures.exe回车打开窗口
  2. 勾选两项： ✅ 适用于 Linux 的 Windows 子系统 ✅ 虚拟机平台
  3. 点击【确定】等待系统部署组件，完成后必须重启电脑

方式 B：命令一键启用（管理员 PowerShell）

powershell

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完毕手动重启电脑。

阶段 2：修复国内网络核心痛点（解决WININET_E_TIMEOUTGitHub 超时）

报错根源

wsl --install第一步强制访问 GitHub 域名raw.githubusercontent.com读取发行版清单，国内 DNS 污染直接超时，先执行本步骤再执行安装命令。

修复操作（管理员 PowerShell）

  1. 编辑系统 hosts 文件

powershell

notepad C:\Windows\System32\drivers\etc\hosts
  1. 文件末尾追加 4 行 IP（永久解析 GitHub 域名）

plaintext

185.199.108.133 raw.githubusercontent.com 185.199.109.133 raw.githubusercontent.com 185.199.110.133 raw.githubusercontent.com 185.199.111.133 raw.githubusercontent.com
  1. 保存文件，刷新 DNS 缓存

powershell

ipconfig /flushdns
  1. 更换网卡公共 DNS（网络设置→IPv4 手动 DNS） 首选：223.5.5.5备用：1.1.1.1
  2. 重置网络栈（可选，彻底修复网络异常）

powershell

netsh winsock reset netsh int ip reset ipconfig /release ipconfig /renew

执行后重启电脑。

阶段 3：在线一键安装 Ubuntu22.04（官方在线命令）

推荐稳定命令（加--web-download绕开微软商店，直连 CDN 下载镜像）

管理员 PowerShell 执行：

powershell

# 指定Ubuntu22.04，直链CDN下载，不依赖商店 wsl --install -d Ubuntu-22.04 --web-download

命令执行流程说明

  1. 先读取 GitHub 发行列表（已通过 hosts 修复可正常访问）
  2. 自动下载 WSL2 内核更新包、Ubuntu22.04 系统镜像
  3. 自动配置默认 WSL2 架构，全程无需手动干预

备选极简命令（网络环境极好时使用）

powershell

# 自动安装默认Ubuntu最新版 wsl --install

执行完成提示

终端输出「安装完成，请重启计算机」，按提示重启电脑。

阶段 4：首次启动 Ubuntu，初始化用户账号

  1. 重启后自动弹出 Ubuntu 终端窗口；未弹出则 Win 键搜索「Ubuntu 22.04 LTS」打开
  2. 按提示设置：
    • 用户名：纯小写英文，无空格 / 中文（示例：dev）
    • 密码：输入时屏幕无显示，输两遍确认
  3. 创建完成后自动进入 Linux bash 终端，在线安装流程结束。

阶段 5：验证在线安装成功

回到管理员 PowerShell 执行查看命令：

powershell

wsl -l -v

正常输出示例：

plaintext

NAME STATE VERSION Ubuntu-22.04 Running 2

NAME=Ubuntu-22.04、VERSION=2，代表 WSL2 在线安装完整生效。

阶段 6：在线安装后系统优化（解决 apt 软件下载慢）

进入 Ubuntu 终端，替换为清华国内软件源：

  1. 编辑源文件

bash

运行

sudo nano /etc/apt/sources.list
  1. 删除全部原有内容，粘贴 Jammy（22.04）清华源

plaintext

deb 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
  1. Ctrl+O保存、Ctrl+X退出，更新软件索引

bash

运行

sudo apt update && sudo apt upgrade -y

在线安装高频报错完整解决方案

报错 1：无法从raw.githubusercontent.com提取列表，操作超时（WININET_E_TIMEOUT）

  • 解决：严格执行【阶段 2】hosts 修改 + DNS 更换；企业内网 hosts 无效则切换离线安装方案

报错 2：0x80072ee7 下载 Ubuntu 镜像失败

  • 解决：命令必须加--web-download；关闭代理；切换手机热点重试

报错 3：执行 wsl --install 只弹出帮助文本

  • 解决：手动分步启用两大 Windows 功能，重启后单独执行安装命令

报错 4：0x800701bc WSL2 内核缺失

  • 解决：手动下载内核包安装：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

powershell

wsl --set-default-version 2

在线安装优缺点对比离线安装

优势

  1. 全自动流程，无需手动下载 1.3GB rootfs 镜像、无需导入命令
  2. 系统自动配置默认登录用户，开箱即用
  3. 微软官方原生流程，兼容性最优，无手动导入异常风险

劣势

  1. 国内网络极易因 GitHub 域名污染超时，必须提前修改 hosts
  2. 企业内网 / 校园网大概率拦截 GitHub，在线命令完全失效，只能改用离线安装