添加新工具链是核心操作,需在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 不会自动同步。











