对话笔记直发:5.23 WSL2安装总结。分类:网络基建。
2026-05-23 WSL2 安装全过程总结
一、重装前备份
备份根目录
D:\back\win11-reinstall-backup-20260522
备份内容
| 分组 | 内容 |
|---|---|
| 核心配置 | OpenCode、Claude、SSH、Git 配置 |
| 浏览器 | Edge、Chrome、Doubao 用户数据 |
| 笔记与云盘 | Obsidian 配置与 vault、OneDrive 个人版与非个人版 |
| WSL | D:\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 完整保留 |
| 用户名密码 | 待设置 |
四、待办事项
- 设置 Ubuntu 用户名密码(进入 WSL 后创建用户、设默认用户)
- 恢复开发环境(OpenCode、Claude、SSH、Git 配置)
- 恢复其他应用数据(浏览器、Obsidian、Listary 等)
- 开始菜单布局还原