# Windows11 下把 WSL2 Ubuntu 26.04 装到 D 盘教程
## 一、背景与目标

在 Windows 上使用 WSL2 跑 Linux 开发环境，默认会装在 C 盘。C 盘空间紧张时，把整个发行版放到 D 盘是更合理的做法。其他盘同理

本文目标：

- 安装 **Ubuntu 26.04 LTS**，WSL 版本为 **2**
- 系统虚拟磁盘落在 **D 盘**，不占 C 盘空间
- 创建用户，同步主机代理
- 验证 WSL 内可正常使用 NVIDIA GPU

最终环境：

| 项目 | 值 |
|---|---|
| Windows | 10.0.26200.8457 |
| WSL | 3.0.1.0 |
| 内核 | 6.18.40.1-1 |
| 发行版 | Ubuntu 26.04 LTS (Resolute Raccoon) |
| 默认版本 | 2 |
| 安装位置 | `D:\WSL\Ubuntu-26.04\ext4.vhdx` |
| GPU | NVIDIA GeForce RTX 5070 Ti |

## 二、整体流程

1. 启用 WSL2 组件
2. 手动下载 Ubuntu 26.04 的 WSL 镜像
3. 用 `wsl --import` 导入到 D 盘
4. 创建普通用户、修复默认用户配置
5. 配置 `.wslconfig` 解决代理提示
6. 设为默认发行版并验证 GPU
<a id="sec3"></a>
## 三、分步操作
### 1. 启用 WSL2 组件

以管理员身份打开 PowerShell：
::: center  
![以管理员身份打开终端](https://developer.qcloudimg.com/http-save/yehe-12806823/ecc4bc288e1e556e6dceb870be78c63e.png)
:::
然后运行（下文中所有的 wsl 命令均在powershell中执行）

```powershell
wsl --install --no-distribution
```

::: center  
![以管理员身份打开终端](https://developer.qcloudimg.com/http-save/yehe-12806823/792e9aabaf01fd792a33a837dde91b30.png)
:::



该命令会安装 WSL 组件并启用 `VirtualMachinePlatform`，但**不安装任何发行版**。

执行后按提示**重启电脑**，否则组件更改不会生效。

确认版本（在powershell中执行）：

```powershell
wsl --version
```

输出示例：

```text
WSL 版本: 3.0.1.0
内核版本: 6.18.40.1-1
WSLg 版本: 1.0.79
MSRDC 版本: 1.2.7214
Direct3D 版本: 1.611.1-81528511
DXCore 版本: 10.0.26100.1-240331-1435.ge-release
Windows 版本: 10.0.26200.8457
```
### 2. 不直接用 wsl --install -d Ubuntu
由于 wsl --install -d Ubuntu 命令会安装在C盘中且直接安装时可能报错：

```text
Wsl/InstallDistro/WININET_E_INVALID_SERVER_RESPONSE
```

这是从服务器下载发行版时网络中断导致的，与系统本身无关。因此此教程中的方法为**手动下载镜像再本地导入**，绕开在线下载环节。
ps:也可以直接执行 wsl --install -d Ubuntu 安装到 C 盘后再迁移到 D 盘，本文为绕开在线下载环节，采用手动导入镜像的方式。

### 3. 下载 Ubuntu 26.04 WSL 镜像

从 Ubuntu 官方或镜像站下载 WSL 专用镜像，镜像网站：
```text
https://releases.ubuntu.com/26.04.1/
```
向下滑找到 ubuntu-26.04-wsl-amd64.wsl 并下载
::: center  
![以管理员身份打开终端](https://developer.qcloudimg.com/http-save/yehe-12806823/e1d93153b49caf6f58b867485602f1d9.png)
:::

大小约 **396MB**。在D盘新建一个WSL目录用来存放镜像与系统，镜像下载后放到 `D:\WSL\` 目录下。

### 4. 导入到 D 盘

在 PowerShell 中执行：

```powershell
wsl --import Ubuntu-26.04 D:\WSL\Ubuntu-26.04 D:\WSL\ubuntu-26.04-wsl-amd64.wsl --version 2
```

参数说明：

- `Ubuntu-26.04`：发行版名称
- `D:\WSL\Ubuntu-26.04`：虚拟磁盘存放目录
- 第三个参数：下载的镜像文件路径
- `--version 2`：指定 WSL2

执行成功会提示“操作成功完成”。

此时 D 盘Ubuntu-26.04目录下会生成 `ext4.vhdx`：

::: center  
![以管理员身份打开终端](https://developer.qcloudimg.com/http-save/yehe-12806823/f10b9ff14a29eda9c80afa456fdbd1f7.png)
:::

在powershell中查看一下
```powershell
dir D:\WSL\Ubuntu-26.04
```
::: center  
![以管理员身份打开终端](https://developer.qcloudimg.com/http-save/yehe-12806823/4c62d1f0e89b50f82b402506dc6a203d.png)
:::



`ext4.vhdx` 就是 Ubuntu 系统的虚拟磁盘，**明虚拟磁盘已落在 D 盘**。
### 5. 首次进入并创建普通用户

```powershell
wsl -d Ubuntu-26.04
```

首次进入默认是 `root` 用户。创建普通用户：

```bash
adduser 你的用户名
usermod -aG sudo 你的用户名
```
输入密码时屏幕不会显示字符，这是正常现象，其他选项直接回车设置成默认值。
这里面，我将 '你的用户名' 替换为 'Hao' 为的我的用户名
确认用户已创建：

```bash
ls /home
```

输出应为自己创建的用户名：

```text
Hao
```

### 6. 修复用户报错

如果 /etc/wsl.conf 中 default= 写入的用户名与实际创建的用户不一致，重启 WSL 会报错
```text
 getpwnam(...) failed
```
 修改方法：

新建 powershell 以 root 身份进入wsl：

```powershell
wsl -d Ubuntu-26.04 -u root
```

写入与adduser一致的用户名：

```bash
cat > /etc/wsl.conf <<'EOF'
[user]
default=Hao
EOF
```

在新建一个 powersehll 重启wsl 生效：

```powershell
wsl --shutdown
wsl -d Ubuntu-26.04
```

提示符变为 `Hao@Hao:~$`，报错消失。


### 7. 配置 .wslconfig 解决代理提示（没有代理可忽略该步骤）

如果 Windows 上开着代理，进入 WSL 会提示：

```text
wsl: 检测到 localhost 代理配置，但未镜像到 WSL。NAT 模式下的 WSL 不支持 localhost 代理。
```

在 `C:\Users\你的Windows用户名\` 下新建 `.wslconfig`：
::: center  
![以管理员身份打开终端](https://developer.qcloudimg.com/http-save/yehe-12806823/8bad58252abd43aa4c8325111132ac2c.png)
:::
注：默认创建的是txt,在 “查看” ，“显示” 中，将文件扩展名选项勾选，将 .txt
后缀名删除使其成为WSLCONFIG文件
::: center  
![以管理员身份打开终端](https://developer.qcloudimg.com/http-save/yehe-12806823/57f7705a513e6f6fdfb70a31e3064f59.png)
:::

用记事本方式打开该文件，复制以下内容并保存退出
```ini
[wsl2]
networkingMode=mirrored

[experimental]
autoProxy=true
```

然后重启：

```powershell
wsl --shutdown
wsl -d Ubuntu-26.04
```

提示消失。

### 8. 设为默认发行版（为了方便，可忽略）

在 powershell 中运行
```powershell
wsl --set-default Ubuntu-26.04
```

之后直接输入 `wsl` 即可进入该系统。

查看状态：

```powershell
wsl --status
```

```text
PS C:\Users\Administrator> wsl --status
默认分发: Ubuntu-26.04
默认版本: 2
当前计算机配置不支持 WSL1。
若要使用 WSL1，请启用“Windows Subsystem for Linux”可选组件。
```

查看列表：

```powershell
wsl -l -v
```

```text
PS C:\Users\Administrator> wsl -l -v
  NAME            STATE           VERSION
* Ubuntu-26.04    Running         2
```

### 9. 验证 Ubuntu 版本

在 WSL 中执行：

```bash
cat /etc/os-release
```

```text
Hao@Hao:~$ cat /etc/os-release
PRETTY_NAME="Ubuntu 26.04 LTS"
NAME="Ubuntu"
VERSION_ID="26.04"
VERSION="26.04 (Resolute Raccoon)"
VERSION_CODENAME=resolute
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=resolute
LOGO=ubuntu-logo
```

### 10. 验证 GPU

```bash
nvidia-smi
```

```text
Thu Oct  8 17:34:44 2026
+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 615.78.02              KMD Version: 617.14        CUDA UMD Version: 13.4     |
+-----------------------------------------+------------------------+----------------------+
| GPU  Name                 Persistence-M | Bus-Id          Disp.A | Volatile Uncorr. ECC |
| Fan  Temp   Perf          Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |
|                                         |                        |               MIG M. |
|=========================================+========================+======================|
|   0  NVIDIA GeForce RTX 5070 Ti     On  |   00000000:02:00.0 Off |                  N/A |
|  0%   31C    P8             16W /  300W |      13MiB /  16303MiB |      0%      Default |
|                                         |                        |                  N/A |
+-----------------------------------------+------------------------+----------------------+

+-----------------------------------------------------------------------------------------+
| Processes:                                                                              |
|  GPU   GI   CI              PID   Type   Process name                        GPU Memory |
|        ID   ID                                                               Usage      |
|=========================================================================================|
|  No running processes found                                                             |
+-----------------------------------------------------------------------------------------+
```

能正常显示，说明 WSL2 的 CUDA 直通已可用。

## 四、最终环境总结

| 项目 | 结果 |
|---|---|
| 发行版 | Ubuntu 26.04 LTS (Resolute Raccoon) |
| WSL 版本 | 3.0.1.0，发行版 VERSION 2 |
| 安装位置 | `D:\WSL\Ubuntu-26.04\ext4.vhdx` |
| C 盘占用 | 不占 |
| 默认发行版 | Ubuntu-26.04 |
| 默认用户 | Hao |
| 网络模式 | mirrored，代理自动同步 |
| GPU | RTX 5070 Ti 可正常识别 |

## 五、小结

- `wsl --install -d Ubuntu` 遇到网络报错时，改为手动下载镜像 + `wsl --import` 更稳
- wsl --import 方式可一步到位把系统装到 D 盘，不需要先装 C 盘再迁移
- 默认用户报错只需修正 `/etc/wsl.conf` 里的用户名
- 代理提示靠 `.wslconfig` + mirrored 模式解决，注意文件名别被存成 `.txt`
- WSL2 可直接使用 NVIDIA GPU，无需额外配置```

本文首发于 CSDN，原文链接：https://blog.csdn.net/m0_74809240/article/details/167279170

未经允许禁止转载，转载请注明出处。


在 Windows 上使用 WSL2 跑 Linux 开发环境，默认会装在 C 盘。C 盘空间紧张时，把整个发行版放到 D 盘是更合理的做法。其他盘同理

Windows11 下把 WSL2 Ubuntu 26.04 装到 D 盘完整

操作系统

开发工具

后端

Windows 11下将WSL2 Ubuntu 26.04完整安装到D盘的全流程教程，涵盖手动下载镜像、wsl --import导入、创建普通用户、修复默认用户配置、配置.wslconfig解决代理问题及验证NVIDIA GPU直通，帮助用户节省C盘空间并实现开发环境自定义部署。

代码解释

服务器

Windows

Ubuntu

Linux

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Windows11 下把 WSL2 Ubuntu 26.04 装到 D 盘完整-腾讯云开发者社区-腾讯云

Windows11 下把 WSL2 Ubuntu 26.04 装到 D 盘完整

Windows11 下把 WSL2 Ubuntu 26.04 装到 D 盘完整

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐