Windows 11 启用 WSL2

警告

Windows 10 下的 WSL2 不支持 “镜像网络模式（mirrored networking）”。该功能仅在 Windows 11（22H2 及以上版本）中提供。

安装步骤

前提条件

1. 开启 CPU 虚拟化

   • 可以在「任务管理器 → 性能 → CPU」确认是否开启
   • 否则进入 BIOS 中启用

2. 启用 Linux 子系统

   以管理员身份运行：

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

   手动启用

   或者直接手动在「启用或关闭 Windows 功能」中勾选：

   • 适用于 Linux 的 Windows 子系统
   • 虚拟机平台

   重新启动电脑。

3. 更新 WSL 和 Linux 内核到最新版本

   wsl --update

   绕过 Windows Update

   如果因为公司组策略限制等原因无法通过 Windows Update 进行更新，则可以用 wsl --update --web-download 命令网络下载最新 WSL 内核。

安装 Linux 子系统

1. 将 WSL 的默认版本设置为 WSL2

   wsl --set-default-version 2

2. 直接安装 Debian

   wsl --install -d Debian

   信息

   也可以从 Microsoft Store 搜索 “Debian” 安装

   信息

   列出可用的 Linux 分发版

   wsl --list --online

   也可以简写为 wsl -l -o。

3. 确认使用 WSL2 并设为默认

   wsl -l -v

   wsl --set-default Debian

   wsl --set-version Debian 2

4. 进入 Linux 子系统

   在 Windows 终端中，点击「+」新建标签页旁边的「∨」下拉列表，选择对应的子系统即可。

   只要退出命令行交互窗口 Linux 子系统就自动停止运行了。

5. 卸载 Linux 子系统

   wsl --unregister Debian

推荐配置

启用 systemd（默认）

在 Linux 系统内执行：

sudo nano /etc/wsl.conf

填入以下内容：

[boot]
systemd=true

重启 Linux 子系统后，执行 systemctl 应该正常工作。

使用镜像网络模式

在 Windows 用户目录下创建/编辑 .wslconfig 文件：

[wsl2]
networkingMode=mirrored

重启 Linux 子系统后 Linux 子系统将会与宿主机共用同一个 IP 地址。

禁用 IPv6

镜像网络模式下 Linux 子系统会优先尝试使用 IPv6（如 Node.js），而国内普遍对 IPv6 的支持较差，可在 Windows 用户目录下的 .wslconfig 中配置禁用 IPv6：

[wsl2]
kernelCommandLine = ipv6.disable=1

设置默认用户

在 /etc/wsl.conf 中配置：

[user]
default=username

将 username 替换为你实际的用户名。此配置指定 WSL 启动时默认登录的用户，而非 root。

如果指定的用户不存在，WSL 会回退到默认行为（以 root 登录）。

修改 Linux 安装目录

1. 备份 Linux 子系统

   wsl --export Debian wsl-debian.tar

   该命令会将 Debian 子系统被分到当前目录下的 wsl-debian.tar 文件。

2. 卸载旧 Linux 子系统

   wsl --unregister Debian

3. 导入 Linux 子系统

   wsl --import Debian D:\wsl\debian C:\Users\Admin\wsl-debian.tar

禁止 Linux 子系统调用 Windows 命令（可选）

修改 /etc/wsl.conf：

[interop]
enabled = false            # 禁用 interop
appendWindowsPath = false  # 禁止自动追加 Windows PATH

重启 Linux 子系统。

重启 Linux 子系统

在 Windows PowerShell 中重启指定实例：

wsl --terminate Debian

或关闭全部正在运行的实例：

wsl --shutdown

警告

在重启之前，必须等子系统停止，给它足够的时间来获取你的更改（推荐 8s 后）。

最佳实践

1. 尽量不要直接在挂载卷中进行开发工作

   跨文件系统 IO 性能差 5–40 倍，建议将代码拷贝到 ~/project、~/workspace 进行开发。

2. 安装 VS Code 的 WSL 插件

3. 推荐直接用 Docker Desktop + WSL 集成，不用在 Debian 里再装 docker.io