clion 运行 cmake 项目无需手动调用 cmake 或 make,依赖内置集成自动完成配置、构建与执行,但需确保 cmakelists.txt 正确、cmake 可执行文件在 path 中(≥3.15)、修改后手动 reload、运行前选中正确目标,并在运行配置中显式设置参数、工作目录及环境变量。

CLion 运行 CMake 项目不需要手动调用 cmake 命令或 make —— 它通过内置的 CMake 集成自动完成配置、构建和执行,前提是 CMakeLists.txt 正确且环境就绪。
确认 CMake 可执行文件已就位
CLion 启动时会自动从系统 PATH 查找 cmake,不依赖你手动指定路径。但常见失败就卡在这一步:
- 终端运行
cmake --version报“command not found”?说明没进PATH:Windows 重装 CMake 时勾选 “Add to PATH”,macOS/Linux 检查~/.zshrc是否追加了export PATH="/opt/homebrew/bin:$PATH"(Homebrew)或对应安装路径 - Settings | Build, Execution, Deployment | CMake 页面中,“CMake executable” 下拉框为空?点右侧文件夹图标手动选
cmake(不是cmake-gui) - 版本低于
3.15?CLion 明确要求 ≥3.15,否则add_executable()或target_link_libraries()解析直接失败,报错只显示 “configure failed”,无具体提示
修改 CMakeLists.txt 后必须手动 reload
CLion 不监听 CMakeLists.txt 文件变更并自动重配置。改完不 reload,新增的 add_executable() 或参数调整完全不会生效:
- 右下角出现黄色提示条 “Reload CMake project” → 点它
- 或右键项目根目录下的
CMakeLists.txt→ 选 “Reload CMake project” - 或按快捷键
Ctrl+Shift+O(Windows/Linux)或Cmd+Shift+O(macOS) - 注意:仅 reload 不触发构建;要运行,还得选对目标并点击 ▶️
运行前必须选中正确的可执行目标
一个 CMakeLists.txt 可能定义多个 add_executable()(如 cplus、forlab、main),但 CLion 默认只运行第一个。不选就容易跑错程序:
- 工具栏中间的下拉框(通常显示项目名)→ 展开后选择你要运行的目标名(如
forlab) - 若目标未出现在列表中,说明 CMake 配置失败或未 reload,检查 CMake 工具窗口中的错误日志
- 也可右键源文件(如
forlab.c)→ “Run ‘forlab’”(CLion 会自动匹配同名 target) - 调试同理:选中目标后按
Shift+Alt+F9,而非直接点虫子图标
命令行参数和工作目录要单独配
CLion 不从 main() 函数签名或注释读取参数,也不默认使用源码所在目录作为工作路径:
- 点击右上角运行配置名称旁的下拉箭头 → “Edit Configurations…” → 在 “Program arguments” 栏输入参数,空格分隔(如
input.txt -v) - “Working directory” 默认是项目根目录;若程序读取相对路径文件(如
fopen("data.bin", "rb")),需设为$ProjectFileDir$/resources或具体路径 - 环境变量(如
LD_LIBRARY_PATH或自定义MY_CONFIG)在同一个配置页的 “Environment variables” 中添加 - 这些设置保存在
.idea/runConfigurations/下,建议开启 “Store as project file” 方便团队共享
最易被忽略的是:CMake reload 和目标选择是两个独立动作,缺一不可;而命令行参数这类运行时配置,完全脱离 CMakeLists.txt,必须在 IDE 的运行配置里显式填——哪怕只传一个 --help,漏设就等于白跑。











