必须先启用WSL子系统，否则wsl命令报错；需满足Windows 11（≥22621）、BIOS开启虚拟化、管理员权限及强制重启，推荐执行wsl --install一键安装并设为WSL2，默认安装Ubuntu。
要在 Windows 11 上运行 Linux 命令行工具、编译开源项目或搭建本地开发环境，必须先启用 WSL 子系统，否则执行 wsl 命令会提示“无法识别”或“功能未启用”，整个过程依赖管理员权限、系统版本达标、BIOS 虚拟化开启及至少一次强制重启。
确认系统与硬件前提
按下 Win + R，输入 winver 回车，查看版本号：Windows 11 所有正式版均支持，但需确保内部版本 ≥ 22621（即 21H2 及以后），低于该版本请先通过「设置 → 更新与安全 → Windows 更新」升级。
右键开始菜单 → 选择「终端（管理员）」→ 输入：systeminfo | findstr /B /C:"System Type" /C:"Virtualization Enabled In Firmware"，确认输出中同时包含 x64-based PC 和 Virtualization Enabled In Firmware: Yes。若后者为 No，必须重启进 BIOS 开启 Intel VT-x 或 AMD-V，【不开启将导致后续所有步骤失败】。
启用 WSL 功能组件
方法一：一键命令（推荐新手）
以管理员身份打开终端 → 直接运行：wsl --install。
该命令自动启用子系统、虚拟机平台、下载内核、安装 Ubuntu 并设为 WSL2，默认全程无需手动干预。
方法二：图形界面启用（适合 PowerShell 受限或需明确勾选者）
按下 Win + R → 输入 optionalfeatures 回车 → 在弹出窗口中严格勾选两项：适用于 Linux 的 Windows 子系统 与 虚拟机平台 → 点击确定 → 等待应用完成并立即重启。
方法三：DISM 命令行（适合脚本部署或无 GUI 场景）
管理员终端中依次执行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart → dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart →
【执行完必须重启，否则下一步 wsl 命令会报错“Feature name is unknown”】。
安装 WSL2 内核并设为默认
第一步：下载并安装内核更新包
访问微软官方页面 https://aka.ms/wsl2kernel，根据 CPU 架构（x64/ARM64）下载对应 wsl_update_x64.msi 或 wsl_update_arm64.msi，双击运行完成安装。
第二步：设默认版本为 2
重启后，再次以管理员身份打开终端 → 运行：wsl --set-default-version 2。
若提示 Invalid argument，说明内核未装好或未重启，需返回上一步检查。
第三步：验证环境就绪
输入：wsl -l -v → 若返回空列表且无错误，说明已就绪；若提示 WSL is not supported，请打开任务管理器 → 性能 → CPU → 查看右下角“虚拟化：已启用”是否为真，否则需重进 BIOS 确认设置。
安装并初始化 Linux 发行版
① 查看可用发行版：wsl --list --online，输出中会列出如 Ubuntu-24.04、Debian、KaliLinux 等名称。
② 安装指定版本（例如 Ubuntu 24.04）：wsl --install -d Ubuntu-24.04。
该命令跳过 Store，直接从 Microsoft 官方源拉取，安装速度更快、更稳定。
③ 首次启动并创建用户：
安装完成后，在开始菜单点击对应发行版图标，或在终端中运行：wsl -d Ubuntu-24.04。
终端将提示 Enter new UNIX username: → 输入非 root 的普通用户名（如 dev）→ 接着设置密码 → 完成后即进入 Bash 环境。
