WSL 2 安装 Ubuntu 24.04 及系统迁移至非系统盘

设置 Root 密码并启用直接登录

# 1. 切换到 root 用户
sudo -i
# 2. 设置 root 密码
passwd
# 3. 退出 Ubuntu
exit

在 Windows PowerShell 中设置默认用户：

# 设置默认用户为 root
wsl --distribution Ubuntu-24.04 --config --default-user root
# 如果需要恢复普通用户，将 username 替换为你的用户名
wsl --distribution Ubuntu-24.04 --config --default-user username

使用 Root 身份安装软件

# 作为 root 用户直接安装
apt update
apt install nginx
# 作为普通用户需要使用 sudo
sudo apt update
sudo apt install nginx

安全提示：日常使用建议保持普通用户身份，仅在需要时使用 sudo。

系统迁移：将 WSL 移动到非系统盘

默认情况下，WSL 子系统安装在 C 盘。以下是将 Ubuntu 24.04 迁移到 F 盘的完整流程。

步骤 1：检查当前系统路径

(Get-ChildItem -Path HKCU:\Software\Microsoft\Windows\CurrentVersion\Lxss | Where-Object { $_.GetValue("DistributionName") -eq 'Ubuntu-24.04' }).GetValue("BasePath") + "\ext4.vhdx"

输出示例：

C:\Users\yourusername\AppData\Local\wsl\{uuid}\ext4.vhdx

步骤 2：创建目标目录

New-Item -ItemType Directory -Path "F:\WSL_imgs\Ubuntu24" -Force

步骤 3：导出系统镜像

# 正确导出命令（注意：目标文件路径必须不存在）
wsl --export Ubuntu-24.04 F:\WSL_imgs\Ubuntu24\ubuntu2404.vhdx --vhd

步骤 4：注销原系统

wsl --unregister Ubuntu-24.04

步骤 5：导入到新位置

# 从导出的镜像重新导入
wsl --import Ubuntu-24.04 F:\WSL_imgs\Ubuntu24 F:\WSL_imgs\Ubuntu24\ubuntu2404.vhdx --vhd

步骤 6：重新配置用户设置

迁移后需要重新设置默认用户：

# 查看当前系统中的用户（需要先启动系统）
wsl -d Ubuntu-24.04
# 在 Ubuntu 中查看用户
cat /etc/passwd | grep '/home'
# 设置默认用户（将 yourusername 替换为你的实际用户名）
wsl --distribution Ubuntu-24.04 --config --default-user yourusername

步骤 7：验证迁移结果

# 查看 WSL 系统状态
wsl -l -v
# 测试启动
wsl -d Ubuntu-24.04

预期输出：

 NAME STATE VERSION
* Ubuntu-24.04 Stopped 2

故障排除与常见问题

问题 1：导出时出现"系统找不到指定的路径"

错误信息：

系统找不到指定的路径。 错误代码：Wsl/ERROR_PATH_NOT_FOUND

解决方案：

# 确保目标目录存在
New-Item -ItemType Directory -Path "F:\WSL_imgs\Ubuntu24" -Force
# 再次执行导出命令
wsl --export Ubuntu-24.04 F:\WSL_imgs\Ubuntu24\ubuntu2404.vhdx --vhd

问题 2：无效的命令行参数错误

错误信息：

无效的命令行参数： -encodedCommand 错误代码：Wsl/E_INVALIDARG

原因：错误地将源镜像路径作为导出目标路径。

正确语法：

# 错误示例（不要这样做）
wsl --export Ubuntu-24.04 C:\Users\...\ext4.vhdx --vhd
# 正确示例
wsl --export Ubuntu-24.04 F:\WSL_imgs\Ubuntu24\ubuntu2404.vhdx --vhd

问题 3：迁移后用户变为 root

解决方案：

# 重新设置默认用户
wsl --distribution Ubuntu-24.04 --config --default-user yourusername
# 验证用户设置
wsl -d Ubuntu-24.04 whoami

问题 4：WSL 2 安装失败

解决方案：

1. 确保 BIOS 中启用了虚拟化技术（VT-x 或 AMD-V）
2. 检查 Hyper-V 是否被禁用
3. 下载并手动安装 https://aka.ms/wsl2kernel

问题 5：磁盘空间不足

检查 WSL 磁盘使用情况：

# 在 Ubuntu 中检查
wsl -d Ubuntu-24.04 df -h
# 清理包缓存
wsl -d Ubuntu-24.04 sudo apt clean

总结

通过本文的详细指导，你应该能够：

1. ✅ 成功安装 WSL 2 和 Ubuntu 24.04 LTS
2. ✅ 配置 Root 用户权限 用于特殊安装需求
3. ✅ 将 WSL 系统迁移到非系统盘，有效节省 C 盘空间
4. ✅ 解决常见的安装和迁移问题

最佳实践建议

1. 定期备份：导出的 .vhdx 文件可以作为系统备份
2. 空间管理：定期使用 apt autoremove 和 apt clean 清理不需要的包
3. 版本控制：使用 wsl --set-version Ubuntu-24.04 2 确保使用 WSL 2
4. 安全使用：日常操作使用普通用户，避免长期使用 root 权限

常用命令速查

# 查看已安装的 WSL 发行版
wsl -l -v
# 设置默认发行版
wsl --set-default Ubuntu-24.04
# 停止所有 WSL 实例
wsl --shutdown
# 导出系统备份
wsl --export Ubuntu-24.04 backup.vhdx --vhd
# 导入系统
wsl --import New-Ubuntu .\path\to\directory backup.vhdx --vhd

现在你已经拥有了一个高性能、可定制且不占用系统盘空间的 Linux 开发环境，可以开始高效的跨平台开发工作了！