CLion如何设置CMake编译工具

夏强吖_7964

夏强吖_7964

2026-09-10

639人浏览

原创

在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 CompilerCXX Compiler 路径正确,例如 /usr/bin/clangC:\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() 调用完全被忽略。

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

CLion 2026.2.0.1
CLion 2026.2.0.1

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

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

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

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

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

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

此时 CLion 会把源码同步到 WSL 路径下,并在 WSL 中执行 cmakeninja。如果看到 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-buildbrew 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

5206

15

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

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

2025.10.23

1371

14

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

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

2025.12.13

314

18

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

0

13

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

2026.09.20

0

15

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单,涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比,助您快速选对适合创作需求的AI视频生成工具。

2026.09.16

160

9

ai生成视频的工具免费版合集
ai生成视频的工具免费版合集

本专题汇总了当前免费AI生成视频工具的排行榜与推荐清单,涵盖seko、讯飞智作、AniShort及剧云、Lovart等多模型集成平台。同时整理了各工具的免费额度、输出时长、水印政策及适用场景差异,助您快速选择合适工具开启AI视频创作。

2026.09.16

60

10

Pandas时间序列分析与可视化报表
Pandas时间序列分析与可视化报表

本专题整理Pandas日期转换、时间索引、重采样、滚动窗口、时区处理、plot绘图、Styler表格样式和报表输出方法。

2026.09.16

80

23

Pandas数据筛选索引与清洗处理
Pandas数据筛选索引与清洗处理

本专题整理Pandas中的loc、iloc、条件筛选、query查询、缺失值处理、重复值删除、类型转换和字符串列清洗方法。

2026.09.16

60

25

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习

CMake 保姆级教程
CMake 保姆级教程

共0课时 | 0人学习