CMakeLists里的project怎么用?

冬伟大大_7937

冬伟大大_7937

2026-08-09

886人浏览

原创

project 是 cmake 构建必需的启动命令,必须位于 cmake_minimum_required 之后,用于定义项目名、版本(触发 projectversion* 变量)和语言(如 languages cxx cuda),顺序错误或缺失将导致变量未定义、编译器未启用或解析失败。

cmakelists里的project怎么用?

project 不是可选配置,它是 CMake 构建系统的启动开关——没它,CMake 就不知道你在构建什么项目,后续很多变量(比如 PROJECT_NAME、PROJECT_SOURCE_DIR)根本不会被定义,add_executable 或 add_library 也可能因语言未激活而失败。

为什么 project 必须放在 cmake_minimum_required 之后?

CMake 要求先确认自己版本够用,再开始解析项目元信息。如果 project 出现在 cmake_minimum_required 前,CMake 会直接报错:

Parse error in CMakeLists.txt: project command must be set before any other command
  • cmake_minimum_required 是唯一允许在 project 之前的命令
  • 哪怕只多一个空行或注释,只要 project 不是第二行(第一行是注释或空白时),某些旧版 CMake(如 3.10 之前)就可能警告或拒绝继续
  • 子目录的 CMakeLists.txt 中不要重复调用 project —— 它只应在顶级文件中出现一次

LANGUAGES 参数不写会怎样?

不显式指定 LANGUAGES,CMake 默认启用 C 和 CXX。但问题在于:如果你的项目只含 .cpp 文件,却没关掉 C,CMake 仍会尝试查找 gcc 并初始化 C 工具链,徒增开销;更麻烦的是,若你依赖 CUDA 或 ASM,不声明就完全不会启用对应编译器支持。

C++ 算法竞赛自动化测试数据生成与校验框架
C++ 算法竞赛自动化测试数据生成与校验框架

根据原题生成新题面、验证器及完整测试数据,自动套用 testlib 模板,用于用户要求生成测试数据时。

下载
  • 纯 C++ 项目建议写成:project(MyApp LANGUAGES CXX)
  • 含 CUDA 的项目必须写:project(MyApp LANGUAGES CXX CUDA),否则 enable_language(CUDA) 可能失效
  • LANGUAGES NONE 是合法但极少用的选项,仅用于极特殊场景(如纯配置生成)

VERSION 参数影响哪些实际行为?

VERSION 看似只是打个标签,但它触发了 CMake 内部一系列变量自动定义和逻辑分支:

  • 设置 project(MyLib VERSION 2.1.0) 后,PROJECT_VERSION_MAJOR 为 2,PROJECT_VERSION_MINOR 为 1,这些变量常被用于条件编译(如 if(${PROJECT_VERSION_MAJOR} GREATER_EQUAL 2))
  • 某些模块(如 CPack)会直接读取 PROJECT_VERSION 生成安装包名,不设 VERSION 就只能得到默认的 0.1
  • 如果用了 find_package(MyLib REQUIRED),且对方 Config.cmake 里写了 set_and_check(MYLIB_VERSION "2.1.0"),那么没设 VERSION 可能导致版本检查失败

最容易被忽略的点:project 的参数顺序不能乱——VERSION 必须紧跟项目名后,LANGUAGES 必须在 VERSION 之后(如果有),否则 CMake 解析失败;另外,项目名里别用空格或特殊字符,否则后续生成的 target 名、变量名都可能出问题。

相关文章

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

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

下载

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

相关专题

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

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

2025.10.17

5466

15

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

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

2025.10.23

1411

14

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

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

2025.12.13

334

18

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

60

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

20

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

20

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

20

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

20

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

20

19

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 入门教程
Conan 2 入门教程

共0课时 | 0人学习

CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习