WSL Ubuntu 26.04 升级与环境整理记录

最近把 WSL 开发环境从 Ubuntu 24.04 升级到 Ubuntu 26.04.1 LTS，同时更新 WSL、调整实例名称、保留原有 VHDX，并优化网络代理配置。

最终环境：

text 复制代码

WSL：3.0.1.0
Linux Kernel：6.18.40.1-microsoft-standard-WSL2
Ubuntu：26.04.1 LTS
WSL Version：2

1. 先升级 WSL

Windows PowerShell 执行：

powershell 复制代码

wsl --update

查看版本：

powershell 复制代码

wsl --version

然后关闭 WSL：

powershell 复制代码

wsl --shutdown

2. 升级 Ubuntu

进入原 Ubuntu：

powershell 复制代码

wsl -d Ubuntu-24.04

先更新现有系统：

bash 复制代码

sudo apt update
sudo apt upgrade

然后执行发行版升级：

bash 复制代码

sudo do-release-upgrade

按照提示完成 Ubuntu 升级。

升级完成后检查：

bash 复制代码

cat /etc/os-release

确认：

text 复制代码

Ubuntu 26.04.1 LTS

3. 修改 WSL 实例名称和目录

关闭 WSL：

powershell 复制代码

wsl --shutdown

原目录：

text 复制代码

D:\WSL\Ubuntu-24.04

改成：

powershell 复制代码

Rename-Item "D:\WSL\Ubuntu-24.04" "Ubuntu-26.04"

确认 VHDX：

powershell 复制代码

Test-Path "D:\WSL\Ubuntu-26.04\ext4.vhdx"

text 复制代码

True

然后注销原实例：

powershell 复制代码

wsl --unregister Ubuntu-24.04

使用原 VHDX 原地注册：

powershell 复制代码

wsl --import-in-place Ubuntu-26.04 "D:\WSL\Ubuntu-26.04\ext4.vhdx"

不会重新复制原来的 271 GB 数据。

4. 验证

powershell 复制代码

wsl --list --verbose

进入：

powershell 复制代码

wsl -d Ubuntu-26.04

检查：

bash 复制代码

cat /etc/os-release

最终：

text 复制代码

Ubuntu 26.04.1 LTS

text 复制代码

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

5. WSL 网络配置

.wslconfig：

ini 复制代码

[wsl2]
networkingMode=mirrored
autoProxy=true
dnsTunneling=true
firewall=true
memory=24GB
swap=8GB

Windows 代理：

text 复制代码

127.0.0.1:10808

WSL 中验证：

bash 复制代码

env | grep -i proxy

可以自动继承：

text 复制代码

HTTP_PROXY=http://127.0.0.1:10808
HTTPS_PROXY=http://127.0.0.1:10808

总结

这次主要完成了四件事：

text 复制代码

WSL 更新
  ↓
Ubuntu 24.04 → 26.04.1 LTS
  ↓
Ubuntu-24.04 → Ubuntu-26.04
  ↓
mirrored + autoProxy + DNS + Firewall

同时保留原有：

text 复制代码

D:\WSL\Ubuntu-26.04\ext4.vhdx

避免重新迁移 271 GB 的开发环境。

最终得到一个 WSL 3.0.1.0 + Ubuntu 26.04.1 LTS + WSL2 + mirrored networking 的新开发环境。