WSL 2 安装 Ubuntu 24.04 及系统迁移到非系统盘
文章目录
- #快速安装使用-wsl-install-命令
- #自定义安装分步安装-wsl-2-和-ubuntu-2404
- #ubuntu-2404-基本配置
- #系统迁移将-wsl-移动到非系统盘
- #故障排除与常见问题
- #总结
在 Windows 上搭建 Linux 开发环境，Windows Subsystem for Linux (WSL) 无疑是最佳选择。本文将详细介绍如何安装 WSL 2、配置 Ubuntu 24.04 LTS，并将其迁移到非系统盘以节省 C 盘空间。
快速安装：使用 wsl --install 命令
对于 Windows 10 版本 2004 及更高版本或 Windows 11 用户，这是最简单的安装方法。
一键安装步骤
重启计算机
# 系统将自动完成 WSL 和默认 Linux 发行版的安装restart-computer执行快速安装命令
wsl --install 以管理员身份打开 PowerShell
# 右键点击开始菜单，选择"Windows PowerShell（管理员）"指定安装 Ubuntu 24.04
如果你想直接安装 Ubuntu 24.04，可以使用以下命令：
wsl --install -d Ubuntu-24.04 优点：
- 自动启用所有必需的 Windows 功能
- 自动下载并安装最新内核
- 设置 WSL 2 为默认版本
自定义安装：分步安装 WSL 2 和 Ubuntu 24.04
如果你需要更多控制权，或者遇到快速安装问题，可以手动分步安装。
步骤 1：启用 WSL 功能
# 以管理员身份运行 PowerShell dism.exe /online /enable-feature/featurename:Microsoft-Windows-Subsystem-Linux /all /norestart 步骤 2：启用虚拟机平台
dism.exe /online /enable-feature/featurename:VirtualMachinePlatform /all /norestart 步骤 3：重启系统
restart-computer步骤 4：设置 WSL 2 为默认版本
wsl --set-default-version 2 如果出现内核更新提示，请下载 https://aka.ms/wsl2kernel。
步骤 5：安装 Ubuntu 24.04
# 查看可用的 Linux 发行版 wsl -l -o # 安装 Ubuntu 24.04 wsl --install -d Ubuntu-24.04 Ubuntu 24.04 基本配置
首次启动配置
安装完成后，首次启动 Ubuntu 24.04 会提示：
- 创建新的 UNIX 用户名（建议使用小写字母）
- 设置用户密码
Root 用户配置与管理
在某些情况下，你可能需要使用 root 用户权限进行操作。
临时切换为 Root 用户
# 在 Ubuntu 终端中执行sudo -i # 或su - 设置 Root 密码并启用直接登录
# 1. 切换到 root 用户sudo -i # 2. 设置 root 密码passwd# 3. 退出 Ubuntuexit在 Windows PowerShell 中设置默认用户：
# 设置默认用户为 root Ubuntu-24.04 config --default-user root # 如果需要恢复普通用户，将 username 替换为你的用户名 Ubuntu-24.04 config --default-user username 使用 Root 身份安装软件
# 作为 root 用户直接安装apt update aptinstall nginx # 作为普通用户需要使用 sudosudoapt update sudoaptinstall 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：创建目标目录
# 在 F 盘创建目标目录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 替换为你的实际用户名） 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
解决方案：
# 重新设置默认用户 Ubuntu-24.04 config --default-user yourusername # 验证用户设置 wsl -d Ubuntu-24.04 whoami 问题 4：WSL 2 安装失败
解决方案：
- 确保 BIOS 中启用了虚拟化技术（VT-x 或 AMD-V）
- 检查 Hyper-V 是否被禁用
- 下载并手动安装 https://aka.ms/wsl2kernel
问题 5：磁盘空间不足
检查 WSL 磁盘使用情况：
# 在 Ubuntu 中检查 wsl -d Ubuntu-24.04 df -h # 清理包缓存 wsl -d Ubuntu-24.04 sudo apt clean 总结
通过本文的详细指导，你应该能够：
- ✅ 成功安装 WSL 2 和 Ubuntu 24.04 LTS
- ✅ 配置 Root 用户权限 用于特殊安装需求
- ✅ 将 WSL 系统迁移到非系统盘，有效节省 C 盘空间
- ✅ 解决常见的安装和迁移问题
最佳实践建议
- 定期备份：导出的
.vhdx文件可以作为系统备份 - 空间管理：定期使用
apt autoremove和apt clean清理不需要的包 - 版本控制：使用
wsl --set-version Ubuntu-24.04 2确保使用 WSL 2 - 安全使用：日常操作使用普通用户，避免长期使用 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 开发环境，可以开始高效的跨平台开发工作了！
