CLion CMake项目创建方法

秋静大大_7843

秋静大大_7843

2026-09-14

911人浏览

原创

最可靠方式是使用CLion的New Project流程并选C++ Executable:自动生成含cmake_minimum_required、project、set(CMAKE_CXX_STANDARD)和add_executable的CMakeLists.txt,确保目标名与项目名一致、源文件同步更新,并配置好工具链。

clion cmake项目创建方法

CLion 创建 CMake 项目最可靠的方式,就是用它自带的 New Project 流程——手动写 CMakeLists.txt 或拖进已有文件再配置,反而容易漏掉关键环节,导致绿色运行按钮一直灰色。

选对项目类型才能自动生成有效 CMakeLists.txt

启动 CLion 后点击 New Project,左侧必须选 C++ Executable(不是 CMake、C++ Library 或空模板)。这个选项会触发 CLion 自动生成带完整骨架的 CMakeLists.txt,包含:

  • cmake_minimum_required(VERSION ...) —— 版本由 CLion 内置工具链决定,改低了可能报错
  • project(...) —— 名称直接来自你填的项目名,不能含空格或特殊字符
  • set(CMAKE_CXX_STANDARD ...) —— 值与你在对话框中选的语言标准严格一致(如选 C++20 就是 20)
  • add_executable(... main.cpp) —— 目标名和源文件名自动绑定,后续改名必须同步

打开已有 CMake 项目时,别直接点文件夹

如果已有项目但没生成过构建目录,不要双击文件夹或用 Open 直接打开根目录——CLion 可能只当普通文件夹处理,不触发 CMake 配置。正确做法是:

  • 点 Open,选中根目录下的 CMakeLists.txt 文件(不是文件夹)
  • 弹出窗口里选 Open as Project,不是 Attach
  • 首次加载时,确保右下角状态栏显示 CMake configuring...,而不是停在 Indexing...

如果卡在 indexing,大概率是 CMakeLists.txt 语法错误,或路径里有中文/空格。

绿色运行按钮变灰?先查这三个地方

按钮灰色 ≠ 代码写错了,而是 CLion 没识别到可执行目标。常见断点:

CLion 2026.2.0.1
CLion 2026.2.0.1

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

下载
  • CMakeLists.txt 里 add_executable() 的第一个参数(目标名)和项目名不一致,且没在 Run Configuration 中手动指定可执行路径
  • main.cpp 被意外重命名,但 add_executable() 里没同步更新文件名
  • CLion 工具链未配置:Settings → Build, Execution, Deployment → Toolchains → 至少有一个生效的 C++ 编译器(如 GCC、Clang、MSVC),且路径可访问

注意:add_executable(myapp main.cpp) 定义的目标名是 myapp,不是 myapp.exe 或 ./myapp;CLion 会自动补全后缀或路径。

Qt / MPI 等依赖项目,CMakeLists.txt 必须提前声明 find_package

想用 Qt、OpenMPI、Boost 等第三方库,不能等编译报错再加 find_package。CLion 在解析 CMakeLists.txt 阶段就需要知道这些依赖是否存在,否则:

  • 代码补全失效(比如 QApplication 不提示)
  • 头文件标红(#include 显示 unresolved)
  • 即使手动编译成功,CLion 的索引和导航也不同步

例如 Qt5 项目,必须在 add_executable 前写 find_package(Qt5Widgets REQUIRED),并确保 CMAKE_PREFIX_PATH 指向 Qt 的 lib/cmake 目录——这个路径一旦写死,换机器就得改,建议用环境变量或 CMake 预设管理。

相关文章

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

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

下载

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

相关专题

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

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

2025.10.17

8006

15

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

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

2025.10.23

1791

14

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

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

2025.12.13

394

18

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

热门下载

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

精品课程

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

共0课时 | 0人学习

LLVM入门手册
LLVM入门手册

共0课时 | 0人学习

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

共0课时 | 0人学习