Windows 11 搭建现代化 WSL2 开发环境

本文记录在 Windows 11 中搭建 WSL2 Linux 开发环境的完整过程，包括：

• 安装最新版 WSL
• 部署 Ubuntu 26.04 LTS
• 将 WSL 迁移到非系统盘
• 调整虚拟磁盘容量
• 配置 Windows Terminal
• 配置 VS Code Remote WSL
• 配置网络环境
• 安装 uv Python 工具链

最终目标是建立一个适合 Python、Node.js、AI 工具链和自动化开发的 Linux
环境。

一、安装 WSL 2

使用管理员 PowerShell：

wsl --install --no-distribution

安装完成后重启系统。

检查版本：

wsl --version

二、安装 Ubuntu 26.04 LTS

查看可用发行版：

wsl --list --online

安装：

wsl --install -d Ubuntu-26.04

如果遇到 GitHub 连接超时，可以：

• 开启代理
• 使用 WSL 官方 .wsl 镜像文件离线安装

示例：

wsl --install --from-file "Ubuntu-26.04.wsl"

三、迁移 WSL 到其他磁盘

WSL 默认安装位置：

C:\Users\<用户名>\AppData\Local\Packages

为了避免占用系统盘，将 Ubuntu 迁移。

导出：

wsl --export Ubuntu-26.04 D:\WSL\ubuntu-backup.tar

注销：

wsl --unregister Ubuntu-26.04

重新导入：

wsl --import Ubuntu-26.04 D:\WSL\Ubuntu-26.04 D:\WSL\ubuntu-backup.tar --version 2

最终结构：

D:
└── WSL
    └── Ubuntu-26.04
        └── ext4.vhdx

四、调整 WSL 虚拟磁盘大小

导入后的虚拟磁盘可能容量过大。

关闭 WSL：

wsl --shutdown

调整：

wsl --manage Ubuntu-26.04 --resize 100GB

WSL 使用动态扩展磁盘：

• 最大容量限制为 100GB
• 实际占用根据使用量增长

五、配置 Windows Terminal

如果直接在 PowerShell 输入：

wsl

WSL 可能进入当前 Windows 目录：

/mnt/c/Users/<用户名>

推荐：

Windows Terminal → Ubuntu 配置：

启动目录：

~

关闭：

使用父进程目录

这样启动后默认进入：

/home/<用户名>

六、配置 VS Code WSL 开发

安装 VS Code 扩展：

WSL
Microsoft

连接：

Ctrl + Shift + P

WSL: Connect to WSL

连接成功后：

WSL: Ubuntu-26.04

此时：

• VS Code 运行在 Windows
• 代码环境运行在 Ubuntu

推荐项目目录：

/home/<用户名>/projects

不要长期在：

/mnt/c/

中开发，因为 Linux 工具链性能会下降。

七、WSL 网络配置

尝试使用 Mirrored 网络模式时，可能导致 VS Code Remote WSL 出现：

WebSocket close with status code 1006

因此最终采用：

WSL:
    NAT

代理工具:
    TUN 模式

推荐配置：

网络模式:
NAT

Hyper-V 防火墙:
开启

localhost 转发:
开启

自动代理:
关闭

DNS 代理:
开启

DNS 隧道:
开启

八、安装 uv

uv 是 Astral 推出的 Python 包管理工具。

安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

加载环境：

source $HOME/.local/bin/env

加入启动环境：

echo 'source $HOME/.local/bin/env' >> ~/.bashrc

检查：

which uv
uv --version

九、配置 uv 国内 PyPI 镜像

新版 uv 不使用 uv config。

编辑：

nano ~/.bashrc

添加：

export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple

重新加载：

source ~/.bashrc

检查：

echo $UV_INDEX_URL

十、最终环境

Windows 11

└── WSL 2
    └── Ubuntu 26.04 LTS

        /home/<用户名>
        |
        ├── projects
        |
        └── uv Python 环境

虚拟磁盘：

<自定义磁盘>
└── WSL
    └── Ubuntu-26.04
        └── ext4.vhdx

后续计划

继续配置：

• nvm + Node.js LTS
• pnpm
• Python 3.12
• faster-whisper
• jieba
• Remotion 开发环境
• Docker

最终形成 Windows + WSL 的现代化开发工作流。