前言#

作为 WSL 的忠实用户，从 2019 年起我就用上了刚诞生的 WSL2。彼时的 WSL2 并不完美，在长期使用过程中曾遭遇以下痛点：

• WSL1/2 转换和升级时失败，导致子系统内的全部文件丢失；
• 开启/关闭 VPN 时可能连不上 WSL；
• vmmem 占用资源奇高；
• 磁盘空间不回收；

时至今日，微软已对 WSL 进行了大量改进。截至 2026 年，WSL 的最新稳定版本已达 2.7.0，内核基于 Linux 6.6 LTS，并引入了镜像网络、自动内存回收、Sparse VHD、Systemd 原生支持、USB 设备直通等一系列重磅特性。本文在原有基础上进行了全面更新，希望帮助大家打造更流畅的 WSL 工作环境。

一、关注 WSL 官方仓库，持续进行内核的更新#

1
wsl --update

1
git clone https://github.com/microsoft/WSL2-Linux-Kernel.git
2
cd WSL2-Linux-Kernel
3
make KCONFIG_CONFIG=Microsoft/config-wsl -j$(nproc)

1
CONFIG_LOCALVERSION="-microsoft-wsl-custom"

1
make KCONFIG_CONFIG=Microsoft/config-wsl -j$(nproc)

1
mv vmlinux /mnt/c/

1
[wsl2]
2
kernel=C:\\vmlinux
3
kernelModules=C:\\modules.vhdx

二、详细配置 .wslconfig，全面优化性能#

按下 Win + R，输入 %UserProfile% 进入用户目录，创建或编辑 .wslconfig 文件。以下是截至 2026 年推荐的完整配置：

1
# 适用于所有 WSL2 发行版的全局配置
2
[wsl2]
3

4
# ── 资源限制 ──────────────────────────────────────────
5
# 限制 VM 最大内存用量（默认为系统内存的 50%）
6
memory=8GB
7
# 虚拟处理器核心数
8
processors=4
9
# 交换空间大小（默认为内存的 25%）
10
swap=4GB
11
# 自定义交换文件路径（可放到非系统盘）
12
# swapfile=D:\\wsl-swap.vhdx
13

14
# ── 网络配置 ──────────────────────────────────────────
15
# 网络模式：mirrored（镜像）是 Windows 11 22H2+ 的推荐模式
16
# 启用后 WSL 与 Windows 共享同一 IP，VPN 兼容性大幅改善
17
networkingMode=mirrored
18

19
# DNS 隧道（Windows 11 22H2+ 默认开启）
20
# 通过虚拟化特性解析 DNS，避免网络数据包冲突，改善 VPN 下的连接性
21
dnsTunneling=true
22

23
# 自动代理：自动同步 Windows 的 HTTP 代理设置到 WSL
24
autoProxy=true
25

26
# 传统 NAT 模式下的端口转发（mirrored 模式下此项被忽略）
27
localhostForwarding=true
28

29
# ── 功能开关 ──────────────────────────────────────────
30
# GUI 应用支持（WSLg），仅 Windows 11 支持
31
guiApplications=true
32
# 嵌套虚拟化（用于在 WSL 中运行 Docker daemon 等）
33
nestedVirtualization=true
34
# 调试控制台（显示 dmesg 输出，排查启动问题时开启）
35
# debugConsole=true
36

37
# ── 崩溃转储 ──────────────────────────────────────────
38
# 最大保留崩溃转储文件数
39
maxCrashDumpCount=3
40

41
[experimental]
42
# ── 内存自动回收 ──────────────────────────────────────
43
# gradual: CPU 空闲时逐步回收缓存内存；dropcache: 立即回收；disabled: 关闭
44
autoMemoryReclaim=gradual
45

46
# ── Sparse VHD（自动收缩虚拟磁盘）────────────────────
47
# 新建发行版将自动创建稀疏 VHD，可随文件删除自动缩小磁盘占用
48
sparseVhd=true

三、配置 wsl.conf，精细控制单个发行版行为#

.wslconfig 是全局配置，而每个发行版内部的 /etc/wsl.conf 用于配置该发行版的特定行为。以下是推荐配置：

1
# /etc/wsl.conf（在 WSL 子系统内编辑）
2

3
[boot]
4
# 启用 Systemd（WSL 2022 年起原生支持）
5
# 启用后可正常使用 systemctl、journalctl 等服务管理命令
6
systemd=true
7

8
[automount]
9
# 自动挂载 Windows 驱动器
10
enabled=true
11
root=/mnt/
12
# metadata 元数据支持使 Linux 文件权限在 Windows 挂载点上生效
13
options="metadata,rw,umask=22,fmask=11"
14
mountFsTab=false
15

16
[network]
17
generateHosts=true
18
generateResolvConf=true
19

20
[interop]
21
# 允许从 WSL 启动 Windows 进程
22
enabled=true
23
# 将 Windows PATH 追加到 WSL 的 PATH 中
24
appendWindowsPath=true
25

26
[user]
27
# 指定默认登录用户
28
# default=yourname

四、资源泄漏？关闭子系统 VM 强制回收内存#

若发现 vmmem 占用资源异常偏高，且当前并未在 WSL 中运行高负载进程，可按以下步骤处理：

方案一（推荐）：启用 autoMemoryReclaim=gradual（见第 2 节 .wslconfig 配置），WSL 将在 CPU 空闲时自动回收缓存内存，从根本上缓解内存膨胀问题。

方案二：若问题已发生，直接强制停止 VM 实例：

1
wsl --shutdown

方案三：若能连入子系统，可用以下命令快速释放 Page Cache：

1
sudo sh -c "echo 3 > /proc/sys/vm/drop_caches"

方案四（彻底排查）：通过 htop 或以下命令定位具体的高占用进程：

1
# 按内存降序列出进程
2
ps aux --sort=-%mem | head -20

五、无法连接 WSL？“参考的对象类型不支持尝试的操作”#

使用 wsl 进入子系统时，有时会提示「参考的对象类型不支持尝试的操作」。这通常是代理软件（如 Clash、Proxifier）和 WSL2 的 Winsock 端口产生了冲突。

修复步骤（依次尝试）：

1
# 步骤一：重置 Winsock 目录（需管理员权限）
2
netsh winsock reset
3

4
# 步骤二：若步骤一无效，重启 LxssManager 服务
5
# 注意：stop 命令是异步的，需等待数秒后再执行 start
6
net stop LxssManager
7
net start LxssManager

方案三（根治）：使用 Proxifier 提供的 NoLsp.exe 工具，通过调用 WSCSetApplicationCategory WinAPI 阻止 Winsock LSP DLL 被加载到 wsl.exe 进程中：

1
NoLsp.exe C:\windows\system32\wsl.exe

此操作会在注册表 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WinSock2\Parameters\AppId_Catalog 中为 wsl.exe 创建一个白名单条目，使 Windows 不再向 wsl.exe 注入 LSP DLL，一劳永逸。

方案四（2025+ 推荐）：切换为 networkingMode=mirrored 网络模式，镜像模式从架构层面绕开了 NAT/Winsock 冲突问题，是最彻底的解决方案。

六、每次唤醒休眠后，CPU 占用奇高？#

可尝试以下几种方法：

1. 使用 Win + Ctrl + Shift + B 重新绘制屏幕；
2. 更新 WSL 内核到最新版本（参考第 1 节）；
3. 在 .wslconfig 中开启 autoMemoryReclaim=gradual，减少唤醒后的内存压力；
4. 具体问题可参考 WSL GitHub Issue #6982。

七、磁盘空间不回收的问题（Sparse VHD 新方案）#

在子系统中执行 du -h --max-depth=1 / 检查实际磁盘占用后，若发现虚拟磁盘文件（ext4.vhdx）体积远大于实际数据，可通过以下三种方案解决：

1
[experimental]
2
sparseVhd=true

1
wsl --manage <发行版名称> --set-sparse true

1
wsl --shutdown
2
diskpart
3
# 在 DiskPart 窗口中执行：
4
# VHD 路径一般为：
5
# C:\Users\<用户名>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu...\LocalState\ext4.vhdx
6
select vdisk file="C:\...\ext4.vhdx"
7
attach vdisk readonly
8
compact vdisk
9
detach vdisk
10
exit

1
# 导出发行版
2
wsl --export Ubuntu D:\WSL\ubuntu-backup.tar
3

4
# 注销原发行版（会删除原数据，请确保已备份）
5
wsl --unregister Ubuntu
6

7
# 在新位置重新导入
8
wsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu-backup.tar --version 2

八、备份与还原：wsl —export / —import#

这是 WSL 最容易被忽视却极为重要的功能。定期备份可避免系统崩溃、WSL 升级失败等导致的数据丢失（正如前言中提到的惨痛经历）。

1
# 查看当前安装的所有发行版
2
wsl --list --verbose
3

4
# 导出发行版（打包为 tar 文件）
5
wsl --export Ubuntu D:\WSL-Backup\ubuntu-$(Get-Date -Format "yyyyMMdd").tar
6

7
# 还原发行版（从 tar 文件导入）
8
wsl --import Ubuntu-Restored D:\WSL\Ubuntu D:\WSL-Backup\ubuntu-20260101.tar --version 2
9

10
# 指定还原后的默认用户（在子系统内执行）
11
# 编辑 /etc/wsl.conf，添加：
12
# [user]
13
# default=yourusername

自动化备份脚本（PowerShell）：

1
# 保存为 wsl-backup.ps1，可配合任务计划程序定期执行
2
$backupDir = "D:\WSL-Backup"
3
$date = Get-Date -Format "yyyyMMdd_HHmm"
4
$distro = "Ubuntu"
5

6
if (-not (Test-Path $backupDir)) { New-Item -ItemType Directory -Path $backupDir }
7

8
Write-Host "正在备份 $distro ..."
9
wsl --export $distro "$backupDir\$distro-$date.tar"
10
Write-Host "备份完成：$backupDir\$distro-$date.tar"
11

12
# 只保留最近 5 个备份
13
Get-ChildItem "$backupDir\$distro-*.tar" |
14
    Sort-Object LastWriteTime -Descending |
15
    Select-Object -Skip 5 |
16
    Remove-Item -Force

九、USB 设备直通：usbipd-win#

WSL2 默认不支持 USB 设备访问，但通过开源项目 usbipd-win 可将 Windows 上的 USB 设备共享给 WSL2 使用，对嵌入式开发（Arduino、ESP32、STM32 等）极为实用。

1
winget install --interactive --exact dorssel.usbipd-win

1
sudo apt install linux-tools-generic hwdata
2
sudo update-alternatives --install /usr/local/bin/usbip usbip \
3
    /usr/lib/linux-tools/*-generic/usbip 20

1
# 1. 列出所有 USB 设备（Windows 端，管理员权限）
2
usbipd list
3

4
# 2. 绑定设备（首次操作，需管理员权限，绑定状态在重启后保持）
5
usbipd bind --busid 4-4
6

7
# 3. 挂载设备到 WSL（无需管理员权限）
8
usbipd attach --wsl --busid 4-4
9

10
# 4. 在 WSL 中验证
11
# lsusb
12

13
# 5. 卸载设备
14
usbipd detach --busid 4-4

1
# 将网络连接类型改为「专用网络」
2
Set-NetConnectionProfile -InterfaceAlias "以太网" -NetworkCategory Private

1
# 例如为 STM32 开发板添加规则
2
echo 'ATTRS{idVendor}=="0483", ATTRS{idProduct}=="374b", MODE="0666"' | \
3
    sudo tee /etc/udev/rules.d/99-stlink.rules
4
sudo udevadm control --reload

十、WSLg：在 WSL 中运行 Linux GUI 应用#

Windows 11 原生支持通过 WSLg（Windows Subsystem for Linux GUI）运行 Linux 图形界面程序，无需安装 X Server。

在 .wslconfig 中确保开启：

1
[wsl2]
2
guiApplications=true

然后在 WSL 中直接安装并运行 GUI 程序：

1
# 安装示例：gedit 文本编辑器
2
sudo apt install gedit -y
3
gedit &
4

5
# 安装 Firefox
6
sudo apt install firefox -y
7
firefox &

应用程序会以原生窗口的形式出现在 Windows 桌面，并在任务栏中显示图标。

十一、开发环境最佳实践#

1
{
2
  "startingDirectory": "//wsl$/Ubuntu/home/yourusername"
3
}

1
# 在 WSL 中，直接用 code 命令打开当前目录
2
code .

十二、Reference#

• WSL 官方仓库
• WSL 配置文档
• WSL 网络配置
• WSL2-Linux-Kernel
• kernel.org
• usbipd-win（USB 设备直通）
• connect-usb 官方文档
• move-wsl（虚拟磁盘迁移）
• wsl.dev 社区资源
• NoLsp.exe 原始下载链接
• zswap in WSL2 优化指南

参考#

• WSL repo
• kernel.org
• config-wsl
• #6982
• move-wsl
• usbipd-win
• Windows Terminal
• WSL 扩展
• WSL 配置文档
• WSL 网络配置
• WSL2-Linux-Kernel
• connect-usb 官方文档
• wsl.dev 社区资源
• NoLsp.exe 原始下载链接
• zswap in WSL2 优化指南