对话笔记直发:5.23 WSL2安装总结。分类:网络基建。

2026-05-23 WSL2 安装全过程总结


一、重装前备份

备份根目录

D:\back\win11-reinstall-backup-20260522

备份内容

分组内容
核心配置OpenCode、Claude、SSH、Git 配置
浏览器Edge、Chrome、Doubao 用户数据
笔记与云盘Obsidian 配置与 vault、OneDrive 个人版与非个人版
WSLD:\WSL 旧目录、WSL 本地状态
开发工具VS Code、Cursor 用户配置
软件配置Listary、Tailscale、Clash
开始菜单布局文件、快捷方式、固定项清单
系统清单已安装软件列表、自启动项、包管理器清单
用户目录补充.wslconfig、.claude、.npm、n8n、CC-Switch 等
恢复文档7 份文档(总说明、清单、恢复顺序、WSL 专项、OpenCode/Claude 说明、软件清单、路径速查)

二、重装后 WSL2 安装过程

第 1 阶段:排查 WSL2 无法启动

  • 初始状态:WSL2 无法运行,提示 BIOS 虚拟化问题
  • 排查发现:重装后 BIOS 虚拟化设置需要确认

第 2 阶段:启用 WSL2 运行层

执行命令:

wsl --update
wsl --install --no-distribution
wsl --set-default-version 2

结果:WSL2 底座成功启动

第 3 阶段:安装 Ubuntu 24.04

wsl --install -d Ubuntu-24.04

结果:从微软在线下载并安装成功,状态 Running,版本 2

第 4 阶段:迁移 WSL 到 D 盘

原因:默认装在 C 盘,用户需要放 D 盘

步骤:

# 1. 导出
wsl --export Ubuntu-24.04 D:\WSL-Backup\Ubuntu-24.04-export.tar
 
# 2. 注销
wsl --unregister Ubuntu-24.04
 
# 3. 导入到 D 盘
wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\WSL-Backup\Ubuntu-24.04-export.tar

结果:

  • C 盘 WSL 目录已清理
  • ext4.vhdx 移至 D:\WSL\Ubuntu-24.04\(1.39GB)
  • 临时备份已删除

第 5 阶段:修复 Windows Terminal

  • 安装了 Ubuntu Mono 字体(winget)
  • Terminal 配置中 Ubuntu-24.04 字体改为 JetBrainsMono Nerd Font
  • 删除了重复的旧版 Ubuntu 配置

三、最终状态

项目状态
WSL2 底座正常
Ubuntu-24.04已安装,Version 2
数据位置D:\WSL\Ubuntu-24.04\ext4.vhdx
Windows Terminal字体已修复,重复配置已清理
备份目录D:\back\win11-reinstall-backup-20260522 完整保留
用户名密码待设置

四、待办事项

  1. 设置 Ubuntu 用户名密码(进入 WSL 后创建用户、设默认用户)
  2. 恢复开发环境(OpenCode、Claude、SSH、Git 配置)
  3. 恢复其他应用数据(浏览器、Obsidian、Listary 等)
  4. 开始菜单布局还原


相关: 00-索引-网络基建索引 openclash配置与WSL代理迁移总结