在CMakeLists.txt的add_library/add_executable中指定头文件有哪些优势？

你提到的两种写法确实都能完成编译，这是因为C++编译器会通过源文件中的#include指令自动处理头文件。不过把头文件显式加入add_library的参数中，有不少实际的优势：

示例代码 #

包含头文件的写法 #

cmake_minimum_required(VERSION 3.0.0)

add_library(HeaderTest HeaderTest.cpp HeaderTest.h)

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
include(CPack)

不包含头文件的写法 #

cmake_minimum_required(VERSION 3.0.0)

add_library(HeaderTest HeaderTest.cpp)

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
include(CPack)

具体优势 #

• IDE 支持更完善：将头文件纳入库目标后，CLion、Visual Studio等IDE能准确识别这些文件属于当前库，代码跳转、自动补全、项目结构展示都会更精准，不会把头文件当作无归属的零散文件。
• 安装与打包更便捷：如果后续需要通过install指令分发库，把头文件加入目标后，配合install(TARGETS ...)的PUBLIC_HEADER属性，就能轻松将头文件同步安装到指定目录，无需额外编写指令单独处理头文件路径。
• 增量构建更可靠：当修改头文件内容时，CMake能检测到该文件属于目标的一部分，自动触发依赖此头文件的源文件重新编译。如果头文件未被加入目标，部分场景下CMake可能无法感知到变化，导致需要手动清理构建目录重新编译，浪费时间。
• 依赖关系更清晰：显式声明头文件属于库目标，能让依赖该库的其他目标更明确地知晓所需包含的头文件。配合target_include_directories的PUBLIC/INTERFACE属性，CMake可以更准确地将头文件路径传递给依赖目标，减少手动设置路径的错误。
• 避免头文件遗漏：在多人协作或大型项目中，将头文件纳入构建系统管理，能确保所有必要的头文件都被跟踪，降低版本控制系统中遗漏头文件的概率（无需手动逐个添加到版本控制）。

内容的提问来源于stack exchange，提问作者Sen