WSL子系统未启用时需通过五种方法之一激活:一、wsl --install一键安装;二、图形界面启用两项功能;三、DISM命令分步启用;四、组策略编辑器配置(专业版以上);五、注册表注入开发许可(家庭版)。

如果您尝试在 Windows 11 上运行 Linux 命令、编译开源项目或搭建本地开发环境,但系统提示“wsl 命令未识别”或“功能未启用”,则说明 WSL 子系统尚未激活。以下是启用 WSL 子系统的多种可靠方法:
一、使用 wsl --install 一键启用并安装
该方法自动启用底层功能、下载最新内核、安装默认 Ubuntu 发行版,并设为 WSL2 模式,适用于绝大多数用户,尤其推荐首次配置者。
1、按下 Win + X 组合键,选择「终端(管理员)」。
2、在弹出的用户账户控制(UAC)提示中点击「是」。
3、输入命令并回车:wsl --install。
4、等待终端显示“Installation complete”及“Restart required”提示。
5、必须重启计算机,重启后 Ubuntu 将自动启动并引导您设置 UNIX 用户名与密码。
二、通过“启用或关闭 Windows 功能”图形界面启用
该方法绕过命令行,全程使用图形化操作,适合对 PowerShell 不熟悉、企业策略限制命令执行或需明确勾选组件的用户。
1、在 Windows 搜索栏输入启用或关闭 Windows 功能,并打开该设置窗口。
2、在列表中找到并勾选以下两项:适用于 Linux 的 Windows 子系统 与 虚拟机平台。
3、点击「确定」,等待系统应用更改并显示“需要重启计算机”提示。
4、保存所有工作后立即重启,否则后续 wsl 命令将不可用。
5、重启后,以管理员身份打开终端,运行 wsl --set-default-version 2 确保新发行版默认使用 WSL2。
三、通过 DISM 命令行分步启用核心功能
该方法直接调用系统部署映像管理工具,不依赖图形界面或 Store 应用,适用于无 GUI 环境、脚本批量部署或组策略禁用“启用或关闭 Windows 功能”的场景。
1、以管理员身份打开 PowerShell 或 CMD。
2、执行第一条命令:dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart。
3、执行第二条命令:dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart。
4、确认两条命令均返回“操作成功完成”字样。
5、重启计算机,重启后继续执行 wsl --set-default-version 2 及后续安装步骤。
四、通过组策略编辑器启用(仅限专业版/企业版/教育版)
该方法修改系统级策略,可同步启用旁加载与 IDE 调试支持,为后续集成 VS Code、Docker Desktop 或 WSLg 图形界面提供策略基础。
1、按下 Win + R,输入 gpedit.msc 并回车。
2、依次展开路径:计算机配置 → 管理模板 → Windows 组件 → 应用程序包部署。
3、在右侧双击打开:允许开发 Windows 应用商店应用并从集成开发环境(IDE)安装这些应用。
4、选择「已启用」,点击「确定」保存。
5、在管理员终端中运行 gpupdate /force 强制刷新组策略,或重启设备使策略生效。
五、通过注册表强制写入开发许可(适配家庭版)
Windows 11 家庭版默认不含 gpedit.msc,此方法通过注册表注入 Appx 开发策略项,模拟开发许可状态,满足 WSL 启动所需的松散文件安装权限。
1、按下 Win + R,输入 regedit,以管理员身份运行注册表编辑器。
2、导航至路径:HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Appx。
3、若 Appx 项不存在,右键「Windows」→「新建」→「项」,命名为 Appx。
4、在右侧空白处右键 →「新建」→「DWORD (32 位) 值」,命名为 AllowDevelopmentWithoutDevLicense。
5、双击该值,将“数值数据”设为 1,点击「确定」保存。










