我为什么建议不要用CMake

最新推荐文章于 2025-11-11 14:03:38 发布
原创 最新推荐文章于 2025-11-11 14:03:38 发布 · 2.3k 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#c++ #开发语言 #CMake

本文指出尽管CMake能统一生成多平台的makefile或project文件，但存在诸多缺点，如不支持相对路径、包含头文件和库文件设置不能重用、版本兼容性差、对持续构建支持不好等。作者推荐在不同平台使用对应工程文件，纳入版本控制，虽需维护多平台文件，但工作量不大。

作者：朱金灿
来源：clever101的专栏

CMake的优点

  CMake在开源代码中最常见的应用场景之一是生成很多平台的makefile或者project文件，这种统一管理的方式确实有其方便之处。尽管CMake有一些优点，我依然不建议使用CMake。下面我要谈谈CMake的一些缺点。

CMake的缺点

CMake不支持相对路径

  这个是CMake的最大缺点之一。很多时候你通过CMake生成了一个project文件，换一下磁盘路径它就不能用了，还得重新生成project文件。

CMake的包含头文件和库文件设置不能重用

  因为CMake不支持相对路径，从而导致CMake生成的project文件并不能重用其他人设置好的包含头文件和库文件的设置。如果采用CMake，一个新人接手一个新项目，估计至少花半天来完成这些设置，期间可能他还要咨询其它同事。

CMake的版本兼容性很不好

  CMake 工具版本太旧的话，可能 CMakeLists.txt 使用了新的语法，就会不兼容；CMake 工具版本太新的话，也会出现不兼容问题，因为 CMake 新版本在更新时不一定向后兼容。

CMake对持续构建支持不好

  我搜过一些jenkins+cmake持续构建C++项目的文章，感觉都是玩具性质的作为，就是说按照这些文章的做法，不用任何第三方库的C++项目可以这么搞。问题是现实中稍微有点规模的C++项目，哪个不需要第三方库呢？要用到第三方库，就必然涉及到包含头文件和库文件的设置，而这个就是CMake的弱项。

更好的做法是什么

  如果不用CMake，那么更好的做法是什么？我推荐的做法是：Windows上直接使用VisualStudio的工程文件，Linux下使用QtCreator或codeblocks的工程文件或makefile，mac平台使用xcodeproject。工程文件都纳入版本控制。这样新手直接下载下来就能用，就能迅速进入项目开发状态了。这样做的缺点可能是需要维护多个平台的工程文件，但我个人认为这些工作量并不大，比如VisualStudio的工程文件和QtCreator的工程文件就能互转，这样只需要把一个维护好就行。

使用CMAKE工具MinGW编译OPENCV报错：CMake Error: CMake was unable to find a build program...如何解决？
**My Coding Family**
04-16 1245
🏆本文收录于《全栈Bug调优(实战版)》专栏，主要记录项目实战过程中所遇到的Bug或因后果及提供真实有效的解决方案，希望能够助你一臂之力，帮你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！ 备注：部分问题/疑难杂症搜集于互联网。
cmake安装和使用
qq_53545309的博客
07-23 1815
在Windows下安装cmake并且配置visualstudio，实现点云可视化
cmake并没有想象中好用
移动开发记录
08-26 361
简单说，CMake可以自动生成各个平台的build（make）文件，从而达到编写一份build脚本就可以自动在各平台生成独自的工程文件。 这似乎听起来很好，但是实际使用中会有各种恶心的问题。导致有的时候我宁愿自己重新搭建工程文件也不想用cmake。 1、首先你要熟悉cmake才能知道为什么它没有成功的生成工程文件，单单一个xxx not found是无法帮助我们解决问题的。但是大多数时...
为什么我们讨厌 CMake，又为什么无法抛弃它？
qq_63315166的博客
01-11 1378
结果，它在无数开发者的需求下越加越多的功能，为了兼容性却不得不保留旧的写法，最终变成了今天的“巨型怪物”。它的核心任务是把所有这些“散装复杂性”整合成一个看起来像样的工作流，让开发者尽量只需要配置一套 CMake 脚本，就能在不同系统、编译器和工具链上跑起来。所以，与其一味抱怨 CMake，不如接受它的不足，去理解它的设计初衷，甚至换一种心态——把学会 CMake 看成一种宝贵的技能投资。很多时候，我们抱怨 CMake 难用，其实不是它本身的问题，而是它必须处理的。不熟悉的东西总是让人感到不舒服，更别提。
技术分享（一）- 简单谈谈工程构建工具之CMake
qq_19257541的博客
04-25 777
前言 以下为我个人使用的cmake的一些经验分享，从背景、工作方式、特点、应用情况以及常见的几个用法，这几个维度去分享cmake的一些经验。由于文章为较早之前的总结文档，若有参考到其他一些文章的内容，请联系我添加相关链接。 出现背景 编译C/C++有好几种 Make 工具，例如 GNU Make ，QT 的 qmake ，微软的 MS nmake，BSD Make（pmake），Makepp，等等。这些 Make 工具遵循着不同的规范和标准，所执行的 Makefile 格式也千差万别。 ...
qt为什么转向用cmake放弃qmake
最新发布
m0_73482095的博客
11-11 683
Qt从qmake转向CMake是其构建系统的重大转型，Qt6全面采用CMake。CMake优势包括：强大的跨平台支持、无缝集成第三方库、符合现代C++标准、完整的开发生命周期支持以及更好的模块化管理。Qt放弃qmake因其局限性，自研的qbs也因生态问题失败。CMake已成为C++构建的事实标准，被主流IDE广泛支持。开发者应优先选择CMake构建新项目，旧项目可逐步迁移。Qt这一转型降低维护成本，拥抱开源生态，为开发者提供更强大、标准的构建体验。
Linux 与 Cmake （一）——了解CMake
Alkaid2000的博客
03-14 3445
我使用的是Ubuntu20.04.1进行学习。 一、那就先使用Linux编写一个C开始吧：Hello World！ （1）在Terminal中编写C语言程序，进行编译调试。首先先熟悉一下Linux的基本操作命令吧： Linux命令的名称 作用 mkdir 新建文件夹 cd 更改当前的工作目录 ls 列出文件夹下包含的文件信息 pwd 查看当前工作目录 cp 拷贝文件 rm 删除文件或文件夹 mv 移动文件 cat 查
makefile再出发[3]学习makefile的方法？为什么要用makefile 不用cmake？
unsv29的专栏
08-14 417
20200814 学习makefile的方法? 首先查资料，看看makefile到底咋学...通过查资料，我发现学习makefile最重要的是不要眼高手低。不要试图突击两三天就掌握个七七八八。在网上找个别人的makefile然后看看是咋运行的，这种学习套路大概是不科学的。 我现在为什么要用makefile？为啥不用cmake？ 对于刚入门的来说，makefile看到的事情能清楚一点。cmake更多的是考虑跨平台。 还有如果写makefile时没有控制住复杂度，那么很容易变得不可维护。这其实就像C语
试用CMake，感觉不错
Four_Kings的专栏
09-28 682
<br />总结一下，初学者可以先看看CMake Practice，已经有热心网友翻译成中文版了，还不错。另外可以参考下Apache的Qpid项目，里面也是用的cmake，很有参考意义。
在Linux下g++、make、cmake的区别以及优劣
weixin_43672168的博客
03-15 1585
在选择编译工具时，应根据具体的项目需求和开发环境来选择。对于小型项目或单文件的编译，使用g++和make可以满足需求。而对于大型项目或多文件的编译，使用cmake可以更加方便和高效。在实际开发中，也可以根据具体情况灵活选择不同的工具来提高开发效率。
CMAKE 使用心得
zlq1233217的专栏
07-23 206
一直都是下载一些功能库在用，很少用到开源的项目，发现CMAKE好多地方用起来不顺手，导出的时候很多错误信息根本查不到。 以下内容注意： NINJA好像是CMAKE的一个扩展，但完全不熟悉，再改用VS平台后出现前后兼容性问题。 把build中的内容删除，就不会出现冲突了。    ...
使用CMake创建CUDA工程
YoungHong1992
11-07 1383
文件，重启后全局全用户可用。如果你用的是自己的机器，或者所在的服务器可以执行重启操作，那么建议你可以这么操作。配置完后需要source一下，或关闭当前shell窗口重启一个新的shell就可用了。如果你没有sudo权限或无法重启机器，那么建议你可以这么操作。的命令看能否找到，如果能找到并输出，证明CUDA的环境变量就配置好了。，这样cmake才能找到CUDA相关的可执行文件和库。编译CUDA工程时，需要在环境变量中配置CUDA的。配置完后需要重启电脑，重新登录后就可用了。在你的工程目录下创建。
cmake常用功能
zxf347085420的博客
10-31 444
3.2 输出带有级别的消息：软件中一般会至少有4种常用信息，一般信息、警告信息、严重错误信息、调试信息等；4、 message Reporting checks查找库日志。：输出作者警告信息，通常用于指出可能影响到项目的重要问题。信息，用于提示用户可能的问题或错误。3.3 输出消息的时候，带有变量的值。可以掺杂在任意位置，不影响业务逻辑。信息，并停止CMake过程。如果不指定，行注释，一直运行到行尾。二、message详解。3.1 输出普通消息。
CMake入门教程【基础篇】版本控制(cmake_minimum_required)
小鱼酱的博客
01-01 780
CMake版本控制(cmake_minimum_required)
cmake和make区别
yygr的博客
01-14 318
对于一个大工程，编写makefile实在是件复杂的事，因而人们又想，为何不设计一个工具，读入全部源文件以后，自动生成makefile呢，因而就出现了cmake工具，它可以输出各类各样的makefile或者project文件,从而帮助程序员减轻负担。但若是源文件太多，一个一个编译时就会特别麻烦，因而人们想到，为何不设计一种相似批处理的程序，来批处理编译源文件呢，因而就有了make工具，它是一个自动化编译工具，你可使用一条命令实现彻底编译。2.用编译器编译代码生成目标文件，如.o。
特别好的CMake
liufengl138的专栏
06-17 1328
http://derekmolloy.ie/hello-world-introductions-to-cmake/ Introduction to CMake by Example Page Contents [hide] 1 Introduction2 Source Code for this Discussion3 Example 1: The Hello World E
cmake的使用-为什么要使用CMake
andrewbytecoder
08-10 1717
介绍 为了将源码转化为最终用户可以实际使用的东西，需要使用到编译器、链接器、测试框架、打包系统等，这些都增加了开发高质量、健壮性软件的复杂性，虽然一些IDE能够将这些过程简化一点，但是开发跨平台的软件并不是总能用到这些IDE的特性。 幸运的是， CMake就是一套可以使上述开发过程易于管理的一套工具，它涵盖了从建立代码工程到发布包的所有过程everything)，CMake不仅涵盖了所有的开发流程，还支持广泛的平台、工具和不同的编程语言。 CMake使用的几个阶段如下： 阶段一、CMake最出名的阶段-
比手写makefile好用一万倍CMake！
遇事不决，问春风
09-19 542
当尝试过写了很多很多的makefile代码因为某些逻辑错误无法修改bug的时候，当因为无法理解文件引用的逻辑时（我深受其害）… makefile？代码引用逻辑就够喝一壶了。 Linux下安装cmake sudo apt-get install cmake 就用四个cmake基本命令吧 # CMakeLists.txt # 指定cmake最小版本 cmake_minimum_required(VERSION 3.0) # 生成项目名称 project(MyLinuxServerTest) # 包含头文件路
cmake教程（为什么要用cmake？）（cmake编译opencv）（就是个跨平台的编译工具Linux、windows）（很重要，必须得学）（报错解决方案）opencv编译
Dontla的博客
08-30 883
CMake：简介及工程应用，及为什么要用CMake，使用CMake自动构建工程 make一下，回头更
使用的是cmake
08-29
<think> 我们之前讨论的是在Qt项目中遇到'QHostInfo: No such file or directory'错误，现在用户是在使用CMake构建Qt项目时遇到同样的错误。因此，我们需要调整之前的解决方案以适应CMake构建系统。 ### 问题分析 在使用CMake构建Qt项目时出现`QHostInfo: No such file or directory`错误，主要原因包括： 1. **CMake未正确配置Qt Network模块**：在`CMakeLists.txt`中没有找到并链接Qt5 Network模块。 2. **Qt安装不完整**：当前Qt安装可能缺少Network组件。 3. **编译器搜索路径问题**：CMake未能正确设置包含路径。 ### 解决方案 #### 步骤1：修改CMakeLists.txt文件 在您的CMakeLists.txt中，确保已经包含了对Qt5 Network模块的查找和链接。具体步骤： 1. **添加`find_package`指令**：确保查找Qt5组件时包含Network模块。 ```cmake find_package(Qt5 COMPONENTS Core Gui Network REQUIRED) # 确保包含Network ``` 2. **将目标链接到Qt5模块**：在使用`target_link_libraries`时链接`Qt5::Network`。 ```cmake target_link_libraries(your_target_name PRIVATE Qt5::Core Qt5::Gui Qt5::Network) ``` #### 步骤2：重新生成构建系统 修改CMakeLists.txt后，必须重新生成构建文件： - 删除构建目录中的所有文件（特别是CMake缓存文件）。 - 重新运行CMake配置和生成步骤。 #### 步骤3：验证Qt安装 如果错误仍然存在，请检查您的Qt安装是否包含Network模块： - 在Qt安装目录下查找`include`子目录，检查是否存在`QtNetwork`目录，例如： ``` <Qt安装路径>/5.15.2/gcc_64/include/QtNetwork ``` 确认该目录下存在`QHostInfo`文件（如`qhostinfo.h`）。 #### 步骤4：手动指定包含路径（备用方案） 虽然通常不需要，但如果CMake未能正确设置包含路径，可以尝试手动添加： ```cmake include_directories(${Qt5Network_INCLUDE_DIRS}) ``` #### 步骤5：检查代码包含语句 确保源代码中正确包含头文件： ```cpp #include <QHostInfo> // 不要使用双引号或相对路径 ``` ### 验证与调试 - 成功标志：重新构建后不再报错。 - 如果问题依旧，可以尝试以下调试方法： 1. 在CMakeLists.txt中添加以下命令打印包含路径信息： ```cmake message(STATUS "Qt5 Network include dirs: ${Qt5Network_INCLUDE_DIRS}") ``` 2. 检查CMake输出的包含路径是否正确。 ### 预防措施 - 在添加新的Qt模块时，务必更新`find_package`和`target_link_libraries`。 - 确保使用兼容的Qt和CMake版本（推荐Qt5.12以上和CMake3.5以上）。 ### 注意事项 - 如果之前使用的是qmake，现在改用CMake，需要将`.pro`文件中的配置（如`QT += network`）转换为CMake的等效配置（即`find_package`和`target_link_libraries`）。 - 如果CMake在配置过程中报错，例如找不到Qt5，请确保正确设置了`CMAKE_PREFIX_PATH`变量指向您的Qt安装目录。例如： ```bash cmake -DCMAKE_PREFIX_PATH=/path/to/Qt/5.15.2/gcc_64 .. ``` ### 相关问题 1. **如何在CMake中正确配置Qt的串口模块(QSerialPort)?** 类似地，您需要在`find_package`中包含`SerialPort`，并链接`Qt5::SerialPort`。 2. **CMake构建过程中出现"Could not open file for write"错误怎么办?** 这通常是文件权限问题或路径包含空格导致，检查构建目录的读写权限以及路径中是否包含空格[^1][^2]。 3. **如何检查CMake是否找到了特定的Qt模块?** 在CMakeLists.txt中添加`message(STATUS "Qt5 Network found: ${Qt5Network_FOUND}")`来查看查找结果。 4. **CMake配置Qt项目的基本框架是怎样的?** 一个最小配置应包括： ```cmake cmake_minimum_required(VERSION 3.5) project(MyQtProject) find_package(Qt5 COMPONENTS Core Gui Widgets Network REQUIRED) add_executable(my_app main.cpp) target_link_libraries(my_app PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets Qt5::Network) ``` </think> ### 解决 CMake 构建 Qt 项目时 "QHostInfo: No such file or directory" 的错误 #### 📌 核心问题分析 该错误表明 CMake 在构建 Qt 项目时无法定位 `QHostInfo` 头文件，主要由于： 1. **CMake 未正确配置 Qt Network 模块**（关键原因） 2. Qt 安装缺少 Network 组件 3. 编译器搜索路径未包含 QtNetwork 头文件 4. CMake 生成的构建文件过期或缓存错误（参考引用[1]的缓存问题） --- ### 🔧 解决方案步骤 按照优先级顺序执行： #### ✅ 1. 修改 CMakeLists.txt 配置（必需） 在您的 `CMakeLists.txt` 中添加 Qt Network 模块依赖： ```cmake cmake_minimum_required(VERSION 3.5) project(YourProjectName) # 关键修改：添加 Network 模块 find_package(Qt5 COMPONENTS Core Gui Network REQUIRED) # 确保包含 Network add_executable(${PROJECT_NAME} main.cpp) # 链接 Network 模块 target_link_libraries(${PROJECT_NAME} PRIVATE Qt5::Core Qt5::Gui Qt5::Network # 必须添加此行 ) ``` #### 🔄 2. 清理并重新生成构建文件 1. **完全删除构建目录**（如 `build/` 文件夹） 2. 重新创建构建目录并运行 CMake： ```bash mkdir build && cd build cmake .. -DCMAKE_PREFIX_PATH="<Your_Qt_Install_Path>" # 例如: /opt/Qt/5.15.2/gcc_64 ``` 3. 重新编译： ```bash make -j4 ``` #### 🔍 3. 验证 Qt 安装 1. 检查 Qt 安装目录是否包含 Network 模块： ```bash ls <Qt_Install_Path>/5.15.2/gcc_64/include/QtNetwork # 确认有 QHostInfo 文件 ``` 2. 如果缺少模块，通过 Qt 维护工具安装 `Qt Network` 组件 #### ⚙️ 4. 手动指定路径（备用方案） 在 `CMakeLists.txt` 中添加显式路径： ```cmake include_directories(${Qt5Network_INCLUDE_DIRS}) # 添加 Network 头文件路径 ``` #### ✏️ 5. 检查源代码包含 确保代码中使用标准包含语法： ```cpp #include <QHostInfo> // 正确写法 // 避免 #include "QtNetwork/QHostInfo" 或相对路径 ``` --- ### 🛠️ 高级调试技巧 1. **检查 CMake 模块查找结果**： ```cmake message(STATUS "Qt5 Network found: ${Qt5Network_FOUND}") message(STATUS "Include dirs: ${Qt5Network_INCLUDE_DIRS}") ``` 2. **检查编译器包含路径**： ```bash cd build make VERBOSE=1 # 查看实际编译命令中的 -I 参数 ``` 3. **修复 CMake 缓存问题**（参考引用[1][3]）： ```bash rm -rf CMakeCache.txt CMakeFiles cmake -DCMAKE_CXX_COMPILER=g++ -G "Unix Makefiles" .. ``` --- ### ️ 预防措施 1. **始终在 `find_package` 中显式声明所需模块** 2. 定期清理构建目录避免缓存问题 3. 使用 CMake 变量指定 Qt 路径： ```bash cmake -DCMAKE_PREFIX_PATH="/opt/Qt/6.2.4/gcc_64" .. ``` 4. 验证模块链接状态： ```cmake if(NOT TARGET Qt5::Network) message(FATAL_ERROR "Qt5 Network module not found!") endif() ``` > 💡 **提示**：如果曾手动修改过 Qt 安装文件（如引用[4]所述），建议重装 Qt 以避免软链接损坏问题。 --- ### ❓ 相关问题 1. **如何在 CMake 中正确配置 Qt 的串口模块(QSerialPort)?** _解决方案类似，需添加 `find_package(Qt5 COMPONENTS SerialPort)` 并链接 `Qt5::SerialPort`_ 2. **CMake 找不到 Qt 安装路径如何解决?** _设置 `-DCMAKE_PREFIX_PATH=<Qt安装路径>` 或配置 `QT_DIR` 环境变量_ 3. **CMake 构建时出现 "Could not open file for write" 错误如何处理?** _检查目录权限，清除 CMake 缓存（参考引用[1]），确保路径无空格（参考引用[2]）_ 4. **如何验证 CMake 是否找到特定 Qt 模块?** _使用 `message(STATUS "Qt5 Network status: ${Qt5Network_FOUND}")` 输出查找结果_
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

clever101

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值