本文基于 Windows 10/11 最新版本撰写,涵盖一键安装、手动配置、性能优化及疑难杂症。

环境检查

在动手之前,请务必确认你的系统版本。WSL 对系统版本有硬性要求,版本过低将无法安装。

查看系统版本步骤

  1. 按下 Win + R 键,输入 winver 并回车。
  2. 在弹出的窗口中查看“版本”和“内部版本号”。

最低要求

  • Windows 10:版本 2004 及以上(内部版本号 19041 及以上)。
  • Windows 11:所有版本均支持。

💡 提示:如果版本过低,请先通过“设置” -> “Windows 更新”升级系统,这是最稳妥的第一步。

除了检查系统版本之外,还需要在 BIOS/UEFI 设置中未开启虚拟化技术(Intel VT-x 或 AMD-V),不然安装会提示“虚拟化功能未启用”,步骤如下。

首先重启电脑进入 BIOS 设置(开机时按 Del、F2 或 F12 键,具体看主板提示),找到“Virtualization Technology”或“SVM Mode”选项,将其设置为 Enabled,保存并重启。

接下来要启动windows功能,我们以管理员身份运行powershell,然后执行下面两条命令。

# 启用"适用于 Linux 的 Windows 子系统"
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用"虚拟机平台"(WSL2 需要)
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

接下来更新 WSL 内核 & 设置默认版本。需要重启 powershell

# 更新 WSL 到最新版本(包含内核更新)
wsl --update
# 设置默认使用 WSL2(不是 WSL1)
wsl --set-default-version 2

开始安装wsl2

WSL2有两种安装方式,新手推荐一键安装即可,老手也建议一键安装。

方案 A:一键安装

如果你的系统版本较新(Windows 10 2004+ 或 Windows 11),这是最快、最省心的方式。

右键开始菜单打开管理员终端,执行命令: wsl --install ,这时候要经过漫长等待,可以先去运动一会再回来看看,记得别设置自动待机哦。

方案 B:手动安装

手动安装太复杂,这里我就不介绍了,建议上面的一键安装。

设置用户名与密码

安装完成后,输入 wsl -l -v 验证是不是wsl2版本。

wsl -l -v
# 应该看到:
# NAME STATE VERSION
# Debian Running 2
24939234-d74a-4688-b10c-53703d32e83c.webp)
wsl版本详情

打开开始菜单,你会看到新安装的 Linux 发行版图标。点击启动,会弹出一个终端窗口进行首次配置。

直接按提示输入小写无空格的用户名,密码直接盲打并重复确认即可。注意:盲打不是随便打

进阶配置

选择发行版(如果你不想用默认的 Ubuntu)

WSL 支持多种 Linux 发行版。你可以查看列表并选择安装。

  • 查看可用发行版

    wsl --list --online
  • 安装指定发行版(例如安装 Debian):

    wsl --install -d Debian

性能优化:配置 .wslconfig

WSL 2 默认会占用较多内存,可以通过配置文件进行限制和优化。在 Windows 用户目录(如 C:\Users\你的用户名\)下创建或编辑文件 .wslconfig

推荐配置

[wsl2]
# 限制内存使用,避免 WSL 吃光所有内存
memory=4GB
# 限制 CPU 核心数(建议设为物理核心数的一半)
processors=2
# 交换文件大小
swap=2GB
# 自动回收未使用内存(Windows 11 22H2+ 支持)
autoMemoryReclaim=gradual
# 启用 localhost 转发(方便在 Windows 浏览器访问 WSL 服务)
localhostForwarding=true

生效方式:修改配置文件后,在 PowerShell 中执行 wsl --shutdown 关闭 WSL,下次启动时新配置生效。

文件系统互访

  • 在 WSL 中访问 Windows 文件:WSL 会自动将 Windows 的盘符挂载到 /mnt/ 目录下。例如,访问 C 盘就是 /mnt/c/,访问 D 盘就是 /mnt/d/

  • 在 Windows 中访问 WSL 文件:在文件管理器的地址栏直接输入 \\wsl$\\wsl$\Ubuntu(将 Ubuntu 替换为你的发行版名称),即可像访问普通文件夹一样访问 WSL 中的文件。

常见问题

最后总结了安装过程中常见的问题已经解决方法。

Q1: 执行 wsl --install 后只显示帮助文档,不安装?

  • 原因:可能系统已经安装了 WSL 核心组件,但未安装发行版。
  • 解决:尝试指定发行版安装,如 wsl --install -d Ubuntu

Q2: 报错 WslRegisterDistribution failed with error: 0x800701bc

Q3: 安装过程中卡在 0% 不动?

  • 原因:网络连接问题导致无法下载发行版镜像。
  • 解决
    1. 尝试使用 --web-download 参数:wsl --install --web-download -d Ubuntu
    2. 如果网络环境特殊(如需要代理),请确保网络通畅。

Q4: 如何卸载 WSL 或某个发行版?

  • 查看已安装的发行版

    wsl --list --verbose
  • 卸载指定发行版(例如卸载 Ubuntu):

    wsl --unregister Ubuntu
  • 完全关闭 WSL

    wsl --shutdown

总结

WSL 的安装过程在 2026 年已经非常简化,核心就是 “管理员权限 + wsl --install。遇到问题时,优先检查系统版本和网络连接。安装完成后,别忘了通过 .wslconfig 进行资源限制,以获得更稳定的双系统体验。

现在,你可以在 Windows 上无缝运行 Linux 命令了!