WSL 全称是 Windows Subsystem for Linux,中文常称为“适用于 Linux 的 Windows 子系统”。它可以让我们在 Windows 中直接运行 Linux 发行版,例如 Ubuntu、Debian、Kali 等,并使用 Bash、APT、GCC、Python、Git、Make、CMake 等常见 Linux 工具。
WSL2 是第二代 WSL,相比 WSL1,它使用真实的 Linux 内核,并通过轻量级虚拟化技术运行 Linux 环境。因此,它对 Linux 系统调用的兼容性更好,也更适合用来进行 C++、Python、Shell、后端服务、嵌入式交叉编译等开发工作。
Win+R 输入 winver 查看版本)。以管理员身份打开 PowerShell,执行以下命令:
wsl --install
命令说明:
Win+I 打开设置 → 应用 → 可选功能 → 更多 Windows 功能。管理员身份打开 PowerShell,执行:
wsl --set-default-version 2
为了避免 WSL 组件过旧,也可以顺手更新 WSL:
wsl --update
如果提示「WSL 2 需要更新其内核组件」,可以先执行 wsl --update,再重启电脑后继续。
安装 Ubuntu 有两种常用方法:一种是通过 Microsoft Store 安装,适合初学者;另一种是不使用微软商店,直接通过 PowerShell 命令安装,适合想快速部署环境或遇到商店下载异常的情况。
Ubuntu 22.04。这种方式操作直观,适合不熟悉命令行的用户。如果 Microsoft Store 打不开、下载速度慢、登录异常,建议使用下面的命令行方式。
以管理员身份打开 PowerShell,先查看当前系统支持安装哪些 Linux 发行版:
wsl --list --online
该命令会列出当前可安装的发行版名称,例如 Ubuntu、Ubuntu-22.04、Debian 等。
然后执行下面命令安装 Ubuntu 22.04:
wsl --install -d Ubuntu-22.04
wsl --install -d Ubuntu-22.04。其中 --install 是两个短横线;发行版名称建议写成 Ubuntu-22.04。如果写成 wsl -install -d ubuntu22.04,部分系统可能无法识别命令或发行版名称。
如果安装过程中出现 Microsoft Store 连接失败、下载卡住、网络异常等情况,可以尝试加入 --web-download 参数,改为从网页渠道下载安装:
wsl --install --web-download -d Ubuntu-22.04
无论采用 Microsoft Store 还是命令行方式安装,完成后都建议在 PowerShell 中执行:
wsl -l -v
正常情况下会看到类似结果:
NAME STATE VERSION
* Ubuntu-22.04 Running 2
NAME:发行版名称。STATE:运行状态,可能是 Running 或 Stopped。VERSION:WSL 版本,显示 2 代表正在使用 WSL2。如果 VERSION 显示为 1,可以执行下面命令转换为 WSL2:
wsl --set-version Ubuntu-22.04 2
安装完成后,可以直接在 PowerShell 中启动 Ubuntu:
wsl -d Ubuntu-22.04
首次启动会初始化 Linux 文件系统,然后要求你设置 Linux 用户名和密码:
sudo 管理员命令,请自己记住。在 Ubuntu 终端中执行以下命令,安装开发依赖:
# 更新软件源
sudo apt update && sudo apt upgrade -y
# 安装 C++ 开发工具链
sudo apt install gcc g++ cmake make git -y
# 验证安装
gcc --version
g++ --version
cmake --version
git --version
wsl --versionwsl --statuswsl --list --verbose 或 wsl -l -vwsl --list --onlinewslwsl -d Ubuntu-22.04wsl --shutdownwsl --set-default Ubuntu-22.04wsl --unregister Ubuntu-22.04(会删除该 Ubuntu 内的所有文件,慎用)/mnt/c/Users/你的Windows用户名/(C盘)、/mnt/d/(D盘);Windows 访问 WSL 文件:在文件资源管理器输入 \\wsl$\Ubuntu-22.04。
虽然 WSL 可以直接访问 Windows 磁盘,但建议把 Linux 项目放在 WSL 自己的家目录中,例如:
mkdir -p ~/projects
cd ~/projects
原因是 Linux 文件系统下的编译、安装依赖和权限管理通常更稳定,尤其适合 C++、Python、Node.js、Go 等项目。
wsl --install 只显示帮助信息:检查 Windows 版本是否过低,或先执行 wsl --update 后重试。0x800701bc:通常是 WSL2 内核组件过旧,执行 wsl --update 后重启电脑。wsl --install -d Ubuntu-22.04 命令安装。wsl --list --online 确认可用发行版名称,再重新安装。wsl --install --web-download -d Ubuntu-22.04。wsl --set-version Ubuntu-22.04 2 转换到 WSL2。sudo dpkg-reconfigure locales,选择 zh_CN.UTF-8 并设为默认。sudo,并输入你设置的 Linux 密码。wsl -l -v 检查版本 → 进入 Ubuntu 安装开发工具链。