Windows 10 安装 WSL2 + Ubuntu-24.04 到 D:\wsl_home 全程避坑记录（专为 Hermes Agent 准备）

技术达芬奇
2 阅读2分钟

Windows 10 安装 WSL2 + Ubuntu-24.04 到 D:\wsl_home 的完整血泪史
（专为 Hermes Agent 准备，全程避坑记录）

最近为了跑 Hermes Agent，在 Windows 10 上把 Ubuntu-24.04 安装到 D 盘，过程非常曲折，踩了很多坑。

特此完整记录下来，供大家参考。

一、最终环境信息

  • 系统：Windows 10 22H2 (19045.6466)
  • WSL 版本：2.7.3.0
  • 内核版本：6.6.114.1-1（已成功升级）
  • 默认发行版：Ubuntu-24.04
  • 默认版本：2

二、提前检查

  • winver 确认 Windows 版本 ≥ 1903
  • 任务管理器 → 性能 → 虚拟化已启用
  • 所有 PowerShell 命令均以管理员身份运行

三、踩过的坑 + 解决方案

  1. wsl --install 超时 → 使用 --web-download 仍失败
  2. wsl --version 命令无效 → 需要先用 dism.exe 手动启用功能
  3. --location D:\wsl_home 一直报错 → Windows 10 对该参数支持较差
  4. 内核无法继续升级 → 从 4.19.x 更新到 5.10.16 后就无法再更新了
  5. --from-file 安装失败 → 最终改用 --import 才成功

重点坑：wsl.exe --update 和 wsl_update_x64.msi 效果完全不一样（最容易踩的坑）

很多人在网上看到“安装 WSL 内核更新包”，就会去下载 wsl_update_x64.msi 并安装。

但实际效果差异很大：

  • wsl_update_x64.msi：这是较老的内核更新包（主要用于早期 WSL 版本），安装后我的内核只停留在 5.10.16。
  • wsl.exe --update（或 wsl --update --web-download）：这是 2025~2026 年推荐的新方式，它会直接从微软服务器拉取最新 WSL 内核和组件，能升级到 6.6.114.1-1。

教训： 优先使用 wsl.exe --update，只有当它失败时才考虑 .msi。我先装了 .msi 很多次都没效果，最后执行 wsl.exe --update 才真正升级成功。

其他常见坑（略）

  1. wsl --install 超时
  2. --location 参数失效
  3. --from-file 安装失败 → 改用 --import
  4. systemd 无法启用（需完整重启 Windows）

四、最终成功的安装步骤（推荐）

  1. 下载文件（你实际使用的文件）：

    • 文件名：ubuntu-24.04.4-wsl-amd64.wsl

  2. 导入到 D 盘（最关键命令）：

    wsl --shutdown

mkdir D:\wsl_home\Ubuntu-24.04

wsl --import Ubuntu-24.04 D:\wsl_home\Ubuntu-24.04 "E:\soft_download\ubuntu-24.04.4-wsl-amd64.wsl" --version 2

    （请把路径改成你实际存放 .wsl 文件的位置）

  3. 设置为默认发行版：

    wsl --set-default Ubuntu-24.04

  4. 首次启动：

    wsl -d Ubuntu-24.04

  5. 创建用户并赋予无密码 sudo 权限：

    sudo adduser tech_davinci --gecos ""
sudo usermod -aG sudo tech_davinci

echo "tech_davinci ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/tech_davinci
sudo chmod 0440 /etc/sudoers.d/tech_davinci

  6. 更新系统：

    sudo apt update && sudo apt full-upgrade -y && sudo apt autoremove -y

  7. 验证安装位置：

    df -h

五、推荐配置

把 tech_davinci 设置为默认用户（以后直接输入 wsl 就进入）：

sudo bash -c 'cat > /etc/wsl.conf << EOF
[user]
default=tech_davinci
EOF'

然后执行：

wsl --terminate Ubuntu-24.04

六、总结

在 Windows 10 上把 WSL 安装到 D 盘，最稳的方法就是：

离线下载 .wsl 文件 + wsl --import

虽然内核只能停留在 5.10.16，但对于安装和运行 Hermes Agent 已经完全足够。

整个过程虽然麻烦，但最终成功把干净的 Ubuntu-24.04 安到了 D:\wsl_home。

avatar
文章
阅读
粉丝