WSL2安装Ubuntu完整教程：自定义安装目录到D盘（--location一键搞定）

Windows 使用 WSL 安装 Ubuntu 详细教程

本文详细介绍如何在 Windows 系统上通过 WSL（适用于 Linux 的 Windows 子系统）安装 Ubuntu，包含完整的命令行操作步骤。

欢迎点赞收藏加关注，关注我的咸鱼用户：代码跑通pytorch,一个金鱼图像。你的支持是我更新的动力。

一、前置条件

• 操作系统：Windows 10（版本 2004 及以上）或 Windows 11
• 权限：需要管理员权限运行 PowerShell

二、检查 WSL 状态

打开 PowerShell（管理员），运行以下命令检查 WSL 是否已安装：

wsl —status

如果提示 未安装适用于 Linux 的 Windows 子系统，说明需要安装。

三、安装步骤

方法一：一键安装（推荐）

直接执行以下命令，会自动完成 WSL 功能启用 + Ubuntu 下载安装：

wsl —install –d Ubuntu

该命令会自动完成：

注意：执行后系统会提示 “请求的操作成功。直到重新启动系统前更改将不会生效。”，此时需要 重启电脑。

方法二：手动安装（旧版 Windows 10）

如果 wsl –install 不可用，需要手动执行以下步骤：

# 1. 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 2. 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 3. 重启电脑

重启后继续执行：

# 4. 设置默认 WSL 版本为 2
wsl —set-default–version 2

# 5. 安装 Ubuntu
wsl —install –d Ubuntu

四、查看可用发行版

如果想查看所有可安装的 Linux 发行版，运行：

wsl —list —online

输出示例：

安装指定版本示例：

wsl —install –d Ubuntu-24.04

五、自定义安装目录（安装到 D 盘）

默认情况下，wsl –install -d Ubuntu 会将系统安装到 C 盘（%LOCALAPPDATA%\\Packages\\ 下）。如果想安装到其他目录（如 D:\\Software\\wsl），可以使用以下方法：

方法一：使用 –location 参数一键安装（推荐）

WSL 支持通过 –location 参数直接指定安装目录，最简单的方式：

wsl —install –d Ubuntu —location D:\\Software\\wsl

该命令会自动完成：

注意：如果 WSL 功能尚未启用，首次执行后需要重启电脑，重启后再次运行该命令即可开始下载安装 Ubuntu。

方法二：先安装再迁移

适用于已经通过 wsl –install -d Ubuntu 安装到 C 盘，想迁移到 D 盘的情况。

# 1. 确认 Ubuntu 已安装并完成初始配置（设置好用户名密码）
wsl –l –v

# 2. 关闭 WSL
wsl —shutdown

# 3. 导出当前 Ubuntu 为备份文件
wsl —export Ubuntu D:\\Software\\ubuntu-backup.tar

# 4. 注销原来的 Ubuntu（会删除 C 盘上的数据）
wsl —unregister Ubuntu

# 5. 创建目标目录并导入到新位置
mkdir D:\\Software\\wsl
wsl —import Ubuntu D:\\Software\\wsl D:\\Software\\ubuntu-backup.tar

# 6. 设置默认登录用户（替换 <你的用户名> 为你之前设置的用户名）
ubuntu config —default-user <你的用户名>

# 7. 删除备份文件（可选）
Remove-Item D:\\Software\\ubuntu-backup.tar

安装验证

# 确认安装位置和版本
wsl –l –v

确认 D:\\Software\\wsl 目录下存在 ext4.vhdx 文件，说明安装成功。

提示：方法一使用 –location 安装的发行版与默认安装体验一致，会出现在开始菜单中。方法二通过 –import 导入的发行版不会出现在开始菜单，需要通过 wsl -d Ubuntu 或 Windows Terminal 启动。

六、重启后首次配置

如果重启后 Ubuntu 没有自动出现，在 PowerShell 中再次运行 wsl –install -d Ubuntu，此时会直接下载安装镜像（不再需要重启）。

七、常用 WSL 命令

八、常见问题

Q1：安装报错 0x80370102

需要在 BIOS 中开启虚拟化技术（Intel VT-x / AMD-V）。

Q2：安装报错 0x800701bc

需要手动下载安装 WSL2 Linux 内核更新包：

• 下载地址：https://aka.ms/wsl2kernel
• 下载后双击安装，然后重试

Q3：WSL 版本为 1，如何升级到 2？

# 查看当前版本
wsl –l –v

# 转换为 WSL 2
wsl —set-version Ubuntu 2

Q4：如何在 VS Code 中使用 WSL？

Q5：Windows 和 Ubuntu 之间如何访问文件？

• 在 Ubuntu 中访问 Windows 文件：/mnt/c/（对应 C 盘）
• 在 Windows 中访问 Ubuntu 文件：资源管理器地址栏输入 \\\\wsl$\\Ubuntu

九、总结

完整安装流程：

检查 WSL 状态 → wsl –install -d Ubuntu → 重启电脑 → 打开 Ubuntu → 设置用户名密码 → 完成

WSL 2 相比 WSL 1 拥有完整的 Linux 内核、更好的文件系统性能和完整的系统调用兼容性，推荐使用 WSL 2。

作者环境：Windows 11 + WSL 2 + Ubuntu

如果本文对你有帮助，欢迎点赞收藏！

以下是新增重装系统如何恢复wsl的情况：

十、重装系统后恢复 WSL

如果 Windows 重装系统后，之前的 WSL 虚拟磁盘文件（ext4.vhdx）仍保留在 D 盘，可以直接恢复，无需重新安装 Ubuntu。

问题现象

重装系统后首次运行 WSL 相关命令，会提示：

wsl: WSL 安装似乎已损坏 (错误代码： Wsl/CallMsi/Install/REGDB_E_CLASSNOTREG)。

解决步骤

第一步：更新 WSL

wsl —update

该命令会自动检测并修复 WSL 组件，更新完成后 重启电脑。

第二步：重新注册已有的 Ubuntu 磁盘

重启后，在 PowerShell（管理员） 中执行：

wsl —import-in–place Ubuntu D:\\Software\\wsl\\ext4.vhdx

–import-in-place 会直接将现有的 ext4.vhdx 文件原地注册为 WSL 发行版，不会复制或移动文件。

第三步：验证恢复结果

# 查看已注册的发行版
wsl –l –v

# 进入 Ubuntu
wsl –d Ubuntu

如果能正常进入 Ubuntu 并且之前的文件和环境都在，说明恢复成功。

提示：通过 –import-in-place 恢复的发行版默认以 root 用户登录。如需恢复为普通用户登录，在 Ubuntu 内执行：

# 查看之前的用户名
ls /home/

然后在 PowerShell 中设置默认用户：

ubuntu config —default-user <你的用户名>