CLion如何设置CMake编译工具

夏强吖_7964

夏强吖_7964

2026-09-10

659人浏览

原创

在CLion中需通过Settings | Build, Execution, Deployment | Toolchains配置工具链:添加Visual Studio(Windows)、Clang(macOS/Linux)或MinGW(Windows)类型,下拉选择Ninja等CMake生成器,并手动指定C/C++编译器路径,确保Ninja在PATH中且Make program字段填入其绝对路径。

clion如何设置cmake编译工具

怎么在 CLion 里选中 Ninja、MSVC 或 Clang 编译器

CLion 默认会尝试自动探测系统中可用的编译器,但实际项目中常需要手动指定——比如用 Ninja 加速构建,或切换到 MSVC 编译 Windows 原生二进制,又或者用 clang 做静态分析。这些不是靠改 CMakeLists.txt 实现的,而是通过 Toolchain 配置生效。

关键点在于:CMake 生成器(Generator)和底层编译器(Compiler)是两个层级。比如你选了 Ninja 生成器,还得告诉 Ninja 具体调用哪个 clang++ 或 cl.exe。

  • 打开 Settings | Build, Execution, Deployment | Toolchains
  • 点击 + 添加新 Toolchain,类型选 Visual Studio(Windows)、Clang(macOS/Linux)或 MinGW(Windows)
  • 在 CMake generator 下拉框中选 Ninja(推荐)或 Visual Studio 17 2022 等;注意:选 Visual Studio 生成器时,CMake generator 项会被锁定,无法手动切 Ninja
  • 确认 C Compiler 和 CXX Compiler 路径正确,例如 /usr/bin/clang 或 C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\bin\Hostx64\x64\cl.exe

如果你看到 Build failed: CMake Error: Could not create named generator,大概率是 Ninja 没装或不在 PATH 中——CLion 不自带 Ninja,需单独安装并确保终端能直接运行 ninja --version。

为什么 CMAKE_C_COMPILER 在 CMakeLists.txt 里设不生效

很多人在 CMakeLists.txt 开头写 set(CMAKE_C_COMPILER "/usr/bin/gcc-12"),结果构建时还是用了系统默认 gcc。这不是 bug,是 CMake 的缓存机制在起作用:一旦 CMake 第一次成功 configure,CMAKE_C_COMPILER 就被写死进 CMakeCache.txt,后续 set() 调用完全被忽略。

真正可靠的设置方式只有两种:

  • 命令行传参:cmake -DCMAKE_C_COMPILER=/usr/bin/gcc-12 -S . -B build(CLion 底层就是这么调的)
  • 环境变量:CC=/usr/bin/gcc-12 cmake -S . -B build,CLion 会在 Toolchain 设置里把 CC 和 CXX 自动注入为环境变量

顺带一提:如果同时设置了 -D CMAKE_C_COMPILER 和 CC 环境变量,前者优先级更高;但如果你在 CLion 的 Toolchain UI 里填了编译器路径,它最终也会转成 -D 参数传给 cmake,所以 UI 设置是最稳妥的入口。

CLion 2026.2.0.1
CLion 2026.2.0.1

CLion 2026.2.0.1 官方历史版本安装包,适合旧项目兼容、开发环境回退、工具链验证、CMake 配置复现和调试行为对比等场景使用。

下载

远程编译时如何让 CLion 使用 WSL 或 Linux 里的编译器

在 Windows 上用 WSL 远程开发时,常见错误是 CLion 本地配置了 MinGW,却想让 CMake 调用 WSL 里的 gcc。这不能靠“换生成器”解决,必须走远程 Toolchain 流程。

  • 先在 Toolchains 页面添加一个 WSL 类型的 Toolchain,填入你的 WSL 发行版名称(如 Ubuntu-22.04)
  • CLion 会自动识别 WSL 中的 gcc、g++、ninja 路径;若未识别,可手动指定 /usr/bin/gcc
  • 在同一个 Toolchain 配置页,勾选 Use WSL 并确认 WSL 根路径(通常是 /home/xxx)
  • 关键一步:在 CMake 设置页(Build, Execution, Deployment | CMake),把 Toolchain 下拉框切换为你刚配的 WSL 条目

此时 CLion 会把源码同步到 WSL 路径下,并在 WSL 中执行 cmake 和 ninja。如果看到 Could not connect to WSL,检查 Windows 系统是否启用 WSL2、是否已运行过 wsl -l -v 确认发行版状态。

cmake --build 执行时卡住或报错找不到 ninja

即使你在 Toolchain 里选了 Ninja 生成器,CLion 构建时仍可能报 ninja: command not found 或卡在 [1/1] Re-running CMake...。这不是 CLion 的问题,而是 Ninja 可执行文件没被正确识别。

  • 确认 Ninja 安装路径已加入系统 PATH:Windows 用户建议用 官方 Ninja 二进制,解压后把目录加进 PATH;Linux/macOS 用 sudo apt install ninja-build 或 brew install ninja
  • 在 CLion 的 Toolchains 页面,展开你当前使用的 Toolchain,找到 CMake generator 下方的 Make program 字段——这里必须显示 Ninja 的绝对路径,比如 /usr/bin/ninja;如果显示为空或错误路径,手动填入
  • 如果用了自定义 Ninja(如 Qt 自带的),别只改 Make program,还要同步更新 CMAKE_MAKE_PROGRAM 缓存变量:在 CMake 设置页的 Environment variables 区域加一行 CMAKE_MAKE_PROGRAM=/path/to/qt/ninja

最隐蔽的坑是:某些预编译 Ninja(尤其是 Qt 提供的)依赖特定版本的 C runtime,和你的 Toolchain 编译器不兼容。这时即使路径对、命令能执行,也会在构建中途静默失败——建议优先使用系统包管理器安装的 Ninja。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

2025.10.17

7246

15

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.23

1691

14

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

2025.12.13

374

18

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

0

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

0

17

Uvicorn安装配置教程
Uvicorn安装配置教程

本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。

2026.11.02

0

17

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

120

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

80

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

280

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM CMake构建指南
LLVM CMake构建指南

共0课时 | 0人学习

LLVM入门手册
LLVM入门手册

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习