WSL 2 的双配置体系（wsl.conf + .wslconfig）完整参考，全量命令速查，systemd 服务管理，以及磁盘空间管理与 VHD 故障修复。
在 WSL2 中安装 Arch Linux 的完整步骤，包括系统初始化、镜像源配置、用户创建、systemd 启用、开发环境搭建，以及与已有 Ubuntu 共存的注意事项。
从 WSL2 启动崩溃排查到性能调优的完整实战指南，涵盖 shell 配置错误修复、内存 CPU 分配策略和 Turborepo 多应用并发优化。
从底层架构理解 WSL 2 的工作原理，通过 WSL 1 vs WSL 2 的全面对比做出正确的版本选型决策，并掌握从安装到开发环境搭建的完整流程。
WSL 2 提供两种网络架构：
NAT 模式下 WSL 2 使用独立的虚拟化以太网适配器，拥有自己的 IP 地址。
从 Windows 访问 Linux 服务：
然后在 Windows 浏览器访问 http://<WSL_IP>:<端口>，或直接使用 localhost（WSL 会自动转发）。
从 Linux 访问 Windows 服务：
然后在 WSL 中使用该 IP 连接 Windows 上的服务。
从局域网访问 WSL 服务（端口转发）：
WSL 2 默认不接受来自 LAN 的直接连接。需要通过 netsh 做端口转发：
查看所有端口转发规则：
删除规则：
[!note]
listenaddress=0.0.0.0表示监听所有 IPv4 地址。应用程序需要绑定到0.0.0.0而非127.0.0.1才能接受外部连接。
镜像模式将 Windows 网络接口「镜像」到 Linux，WSL 和 Windows 共享网络栈。
启用方式，在 %USERPROFILE%\.wslconfig 中添加：
镜像模式的优势：
127.0.0.1 直接互通，无需查询 IP防火墙配置（管理员 PowerShell）：
Windows 11 22H2+ 默认启用 DNS 隧道，通过 WSL 内的虚拟化功能响应 DNS 请求，而非通过网络数据包。这改善了 VPN 等复杂网络环境下的 DNS 解析。
启用后 WSL 自动使用 Windows 的 HTTP 代理配置：
WSL 2 使用独立虚拟网卡，网络行为与 Windows 侧不完全一致。根据实际网络环境选择适配方案。
Windows 11 22H2+ 用户首选。在 .wslconfig 中启用镜像模式和自动代理后，WSL 会自动继承 Windows 侧的网络和代理配置，无需额外设置：
[!tip] 启用镜像模式后，WSL 和 Windows 共享网络栈，VPN 流量会自动穿透到 WSL 内，不需要手动配代理。
如果使用默认 NAT 模式（Win10 或未配置镜像模式），需要在 WSL 内手动设置代理。将以下内容添加到 ~/.bashrc：
[!note] 端口号根据实际代理工具调整（Clash 默认 7890，V2Ray 默认 10809 等）。不需要代理时注释掉即可。
此方案的原理是：NAT 模式下 Windows 是 WSL 的网关（通过
resolv.conf中的 nameserver 获取 IP），代理流量通过网关转发到 Windows 侧的代理软件。
如果使用 VPN 后 WSL 内域名解析异常，启用 DNS 隧道可以解决：
WSL 2 通过 WSLg 支持直接在 Windows 桌面上运行 Linux GUI 应用（X11 和 Wayland），具有以下特性：
Alt+Tab 在 Linux 和 Windows 应用间切换[!warning] WSLg 不提供完整桌面体验。它依赖 Windows 桌面，不支持安装桌面环境或以桌面为中心的工具。
先更新软件包：
GIMP（图像编辑器）：
Nautilus（文件管理器，类似 Windows 资源管理器）：
VLC（多媒体播放器）：
GNOME 文本编辑器（Ubuntu 22.10+ 默认编辑器）：
旧版 Ubuntu 使用 gedit：
Google Chrome：
Microsoft Edge（Linux 版）：
X11 工具集（计算器、时钟等）：
如果 GUI 应用无法启动，参考 WSLg 故障诊断指南。
WSL 2 支持两种 GPU 加速方案：NVIDIA CUDA 和 DirectML。
适用条件： 拥有 NVIDIA 显卡。
步骤：
在 Windows 侧安装 NVIDIA 最新驱动
在 WSL 中安装 Docker：
适用条件： AMD、Intel 或 NVIDIA 显卡均可。
步骤：
如果机器有多个 GPU，通过环境变量选择：
使用字符串匹配，例如设置为 "NVIDIA" 会匹配以 NVIDIA 开头的第一个 GPU。
WSL 2 不原生支持 USB 设备，需要通过 usbipd-win 开源项目桥接。
uname -a 检查，通过 wsl --update 更新）方式一：winget
[!warning] 不要省略
--interactive，否则安装驱动时可能直接重启电脑。
方式二：手动安装
从 usbipd-win Releases 下载 .msi 安装器。
安装后会产生：
usbipd 服务（可通过 Windows 服务管理器查看状态）usbipd 命令行工具确保 WSL 终端已打开（保持 WSL 2 VM 运行）
以管理员身份打开 PowerShell，列出所有 USB 设备：
4-4），绑定设备：[!warning] USB 设备连接到 WSL 后，Windows 将无法使用该设备。所有 WSL 2 发行版共享该设备。
物理断开 USB，或在 PowerShell 中执行：
Microsoft Store 外的 Linux 发行版（如 CentOS、Alpine、Gentoo 等）可以通过 tar 文件导入到 WSL 2。
方式一：从官方下载
例如 Alpine Linux 在下载页面提供「Mini Root Filesystem」的 tar 文件。
方式二：从 Docker 容器导出
以 CentOS 为例：
默认以 root 用户启动。在发行版内创建用户：
重启使生效：
如果需要将自定义发行版打包为 UWP 应用（行为与 Store 发行版完全一致），可以按照微软官方的 构建自定义发行版指南 进行操作。
[!note]
wsl --import-in-place <发行版> <vhdx文件>可以将一个已有的 ext4 格式 .vhdx 文件直接导入为 WSL 发行版，无需 tar 文件中转。