添加新工具链是核心操作，需在Settings→Build, Execution, Deployment→Toolchains中点击+选择模板（如Custom），完整指定编译器、调试器等可执行文件路径，并在CMake Profile中手动绑定该工具链，否则不生效。
添加新工具链（Toolchain）是核心操作
CLion 不叫“添加编译环境”，而是通过 Toolchains 配置来定义整套构建工具：编译器、链接器、调试器。你不能只填一个 gcc 就完事，必须成套指定，否则 CMake 会找不到 arm-none-eabi-g++ 或报 Unknown compiler 错误。
操作路径固定：Settings > Build, Execution, Deployment > Toolchains → 点右上角 + → 选模板（如 MinGW、Visual Studio、Custom）。
- 选
Custom最灵活，适合嵌入式（比如arm-none-eabi-gcc）或非标准 MinGW 路径 - 选
Visual Studio模板时，CLion 会自动扫描注册表找已装的 VS 版本；若没扫到，手动填Visual Studio installation path，比如C:\Program Files\Microsoft Visual Studio\2022\Community - 选
MinGW模板后，必须点开MinGW path并指向实际安装目录（如C:\mingw64），不能只填bin子目录 - 所有编译器路径必须是可执行文件全路径，例如：
C:\tools\gnu-arm\bin\arm-none-eabi-gcc.exe，不是目录
Windows 下用 MSVC 时容易漏掉 vcvars 脚本
CLion 启动 MSVC 编译器前，需要先运行 vcvarsall.bat 来设置环境变量（如 INCLUDE、LIB）。如果跳过这步，会遇到 cl: command not found 或 Cannot find Windows SDK。
在 Toolchain 设置里，找到 Environment script 字段，填入对应架构的脚本路径，例如：
C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat
- VS 2022 默认不带
vcvarsall.bat，但vcvars64.bat是等效替代 - 若用旧版 VS（如 2019），路径中年份要改成
2019，脚本名保持vcvars64.bat - 不要勾选
Use default environment，否则 CLion 会忽略你填的脚本
CMake Profile 必须绑定刚配的 Toolchain
光配好 Toolchain 不生效——CMake 还不知道该用哪套工具。你得在 Settings > Build, Execution, Deployment > CMake 里新建或编辑一个 Profile，并在 Toolchain 下拉框中选择刚才创建的那个名字（比如 ARM 或 VS2022-x64）。
否则 CMake 会继续用默认的系统 gcc 或报错：CMAKE_C_COMPILER is not a full path to an existing compiler tool。
- 如果项目已有
CMakeLists.txt，记得删掉cmake-build-*目录再重载，否则缓存可能沿用旧配置 - 交叉编译（如 ARM）必须加
-DCMAKE_SYSTEM_NAME=Generic等参数，这些写在CMake options里，不是 Toolchain 设置项 - 多个 Profile 可共存（比如一个给 STM32，一个给 ESP32），切换时 CMake 会自动重配置
验证是否真生效：看状态栏和编译日志
别只信设置界面勾上了就完事。真正生效要看两个地方：
- 右下角状态栏是否显示你命名的工具链（如
ARM），而不是Default或空白 - 点击
Build后，终端输出的第一行是否含你指定的编译器路径，例如：Running C:\tools\gnu-arm\bin\arm-none-eabi-gcc.exe ... - 如果看到
gcc.exe（没带arm-none-eabi-前缀）或cl.exe但路径不对，说明 Profile 没绑对，或 Toolchain 的编译器字段填错了可执行文件
最常被忽略的是：改完 Toolchain 后没去 CMake 页面重新选一遍 Profile —— 这一步必须手动做，CLion 不会自动同步。
