WSL 2 安装 Ubuntu 24.04 及系统迁移至非系统盘 | 极客日志

Shell / Bash

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

在 Windows 环境下安装 WSL 2 并部署 Ubuntu 24.04 的完整流程。内容涵盖使用 wsl --install 命令的一键安装方式，以及分步手动安装 WSL 功能和虚拟机的详细步骤。文章还包含了 Ubuntu 首次启动配置、Root 用户权限设置与管理、以及将 WSL 系统从 C 盘迁移至非系统盘（如 F 盘）的具体操作方法，包括导出、注销、导入和重新配置用户等关键步骤。此外，针对迁移过程中可能遇到的路径错误、参数无效、用户权限变更等常见问题提供了排查方案，并给出了系统维护、备份及安全使用的最佳实践建议。

BackendPro发布于 2026/3/22更新于 2026/4/1819K 浏览

在 Windows 上搭建 Linux 开发环境，Windows Subsystem for Linux (WSL) 无疑是最佳选择。本文将详细介绍如何安装 WSL 2、配置 Ubuntu 24.04 LTS，并将其迁移到非系统盘以节省 C 盘空间。

快速安装：使用 wsl --install 命令

对于 Windows 10 版本 2004 及更高版本或 Windows 11 用户，这是最简单的安装方法。

一键安装步骤

重启计算机

Restart-Computer

wsl --install

wsl --install -d Ubuntu-24.04

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Restart-Computer

wsl --set-default-version 2

# 查看可用的 Linux 发行版
wsl -l -o
# 安装 Ubuntu 24.04
wsl --install -d Ubuntu-24.04

sudo -i
# 或
su -

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

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

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

(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

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

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

wsl --unregister Ubuntu-24.04

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

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

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

 NAME STATE VERSION
* Ubuntu-24.04 Stopped 2

系统找不到指定的路径。 错误代码：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

无效的命令行参数： -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

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

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

# 查看已安装的 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

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

快速安装：使用 wsl --install 命令

一键安装步骤

指定安装 Ubuntu 24.04

自定义安装：分步安装 WSL 2 和 Ubuntu 24.04

步骤 1：启用 WSL 功能

步骤 2：启用虚拟机平台

步骤 3：重启系统

步骤 4：设置 WSL 2 为默认版本

步骤 5：安装 Ubuntu 24.04

Ubuntu 24.04 基本配置

首次启动配置

Root 用户配置与管理

临时切换为 Root 用户

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

使用 Root 身份安装软件

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

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

步骤 2：创建目标目录

步骤 3：导出系统镜像

步骤 4：注销原系统

步骤 5：导入到新位置

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

步骤 7：验证迁移结果

故障排除与常见问题

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

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

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

问题 4：WSL 2 安装失败

问题 5：磁盘空间不足

总结

最佳实践建议

常用命令速查

更多推荐文章

相关免费在线工具

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

快速安装：使用 wsl --install 命令

一键安装步骤

指定安装 Ubuntu 24.04

自定义安装：分步安装 WSL 2 和 Ubuntu 24.04

步骤 1：启用 WSL 功能

步骤 2：启用虚拟机平台

步骤 3：重启系统

步骤 4：设置 WSL 2 为默认版本

步骤 5：安装 Ubuntu 24.04

Ubuntu 24.04 基本配置

首次启动配置

Root 用户配置与管理

临时切换为 Root 用户

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

使用 Root 身份安装软件

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

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

步骤 2：创建目标目录

步骤 3：导出系统镜像

步骤 4：注销原系统

步骤 5：导入到新位置

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

步骤 7：验证迁移结果

故障排除与常见问题

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

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

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

问题 4：WSL 2 安装失败

问题 5：磁盘空间不足

总结

最佳实践建议

常用命令速查

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具