CLion在Windows上调用WSL工具链可行，但需同时满足WSL2启用、发行版运行中、CLion识别wsl.exe及Linux工具三条件；否则出现工具链未配置、CMake未找到或调试器灰显等问题。
CLion 在 Windows 上直接调用 WSL 工具链是可行的，但必须满足 WSL2、正确安装发行版、且 CLion 能识别到 wsl.exe 和 Linux 内部工具这三者同时成立——缺一不可。否则你会看到 Toolchain is not configured、CMake executable not found 或调试器灰显等现象。
确认 WSL2 已启用并运行 Ubuntu（或其他发行版）
这是整个配置的前提，不是“装了就行”，而是要验证状态和版本：
- 以管理员身份打开 PowerShell，运行
wsl -l -v，输出中VERSION列必须为2，且对应发行版状态为Running - 若显示
VERSION 1，执行wsl --set-version 2（如wsl --set-version Ubuntu-22.04 2） - 若无任何发行版，先运行
wsl --install（Win11 22H2+）或从 Microsoft Store 安装 Ubuntu - 首次启动 Ubuntu 后，务必完成用户初始化（设置用户名/密码），否则后续
sudo操作会失败
在 WSL 中安装必要构建工具（不能跳过）
CLion 不会帮你装 gcc、gdb、cmake，它只检测已存在的二进制。WSL 默认安装不带开发套件：
- 进入 WSL 终端（如
ubuntu），执行：sudo apt update && sudo apt install -y build-essential gdb cmake ninja-build - 特别注意：
build-essential包含gcc、g++、make；单独装gcc不够 - 如果用 ESP-IDF 等嵌入式框架，还需额外安装 Python、
git、libncurses-dev等依赖，否则 CMake 配置阶段就会报错 - 验证是否就位：
which gcc cmake gdb应返回路径（如/usr/bin/gcc）
CLion 中添加并设为默认 WSL 工具链
关键动作不是“点+选WSL”，而是确保 CLion 实际读取到了 WSL 里的可执行文件：
- 打开
File | Settings | Build, Execution, Deployment | Toolchains - 点击
+→ 选择WSL，此时右侧应自动列出已安装的发行版（如Ubuntu-22.04） - 若列表为空，检查：①
wsl.exe是否在系统 PATH 中（通常C:\Windows\System32已包含）；② WSL 是否处于Running状态 - 选中发行版后，等待下方
CMake、Compiler、Debugger字段被自动填充（路径形如/usr/bin/cmake） - 将该 WSL 工具链拖拽至顶部，设为项目默认——否则新建 C++ 项目时仍可能回退到 MinGW
CMake 配置必须绑定 WSL 工具链（常见漏项）
很多人配完 Toolchain 就以为结束了，但 CMake 构建配置是独立一层，不手动指定就会用错环境：
- 进入
File | Settings | Build, Execution, Deployment | CMake - 在
Toolchain下拉菜单中，必须手动选择你刚配置的 WSL 条目（不是Default，也不是Bundled MinGW） -
Generator推荐选Ninja（比 Make 快，且 WSL 中默认已装） - 如果项目已有
CMakeLists.txt，点击右上角Reload project按钮强制重新解析，否则旧缓存可能导致Could not find compiler set in environment variable CC - 编译输出路径（
Build directory）建议设为 WSL 路径（如~/myproject/build），避免 Windows 路径在 WSL 中权限或路径转换问题
最易忽略的是：WSL 工具链一旦配置成功，所有构建、运行、调试操作都发生在 Linux 环境中，包括 main() 的执行和 GDB 断点——这意味着 Windows 上的防火墙、杀软、甚至 PowerShell 执行策略都完全不影响它，但 WSL 自身的 /etc/hosts、~/.bashrc 初始化、以及 USB 设备桥接（如 ESP32 烧录）这些 Linux 层面的事，就得单独处理了。
