CMake多目录C++库：源文件正确包含方式咨询

手动罗列文件的优劣势 #

• 优点：完全可控，CMake能精准追踪文件变更，不会出现意外包含或遗漏的情况，适合文件数量少、结构稳定的小型项目。
• 缺点：项目规模扩大后，新增/删除文件都要手动修改CMakeLists.txt，维护成本高，容易出错。

Glob遍历的正确用法及注意事项 #

如果你想用自动遍历替代手动罗列，CMake的file(GLOB_RECURSE)可以实现多层目录扫描，但新手常踩的坑是文件变更后CMake不会自动重新扫描，解决方法如下：

# 遍历所有.cc和.cpp文件，CONFIGURE_DEPENDS让CMake自动检测文件增减（需CMake 3.12+）
file(GLOB_RECURSE PROJECT_SOURCES CONFIGURE_DEPENDS
    "*.cc"
    "*.cpp"
)

add_library(${PROJECT_NAME} STATIC ${PROJECT_SOURCES})

注意：

• 旧版本CMake（3.12之前）不支持CONFIGURE_DEPENDS，此时新增文件后需要手动重新运行cmake命令才能生效。
• 尽量避免模糊匹配（比如只写*），容易包含临时文件或无关代码，建议指定明确的源文件后缀。

更推荐的模块化管理方案（多层嵌套项目首选） #

对于多层嵌套的项目，最省心的方式是用add_subdirectory拆分模块，每个子目录编写独立的CMakeLists.txt，示例如下：

根目录CMakeLists.txt

cmake_minimum_required(VERSION 3.12)
project(MyNestedProject)

# 引入子目录，CMake会自动处理该目录下的CMakeLists.txt
add_subdirectory(nested)

nested/folder/with/CMakeLists.txt

# 该目录下的源文件仅在此处管理
add_library(WithModule STATIC source.cc)

# 指定该模块对外暴露的头文件目录，PUBLIC表示链接此模块的目标会自动继承该目录
target_include_directories(WithModule PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

这种方式的好处：

• 每个模块只负责自己的源文件和依赖，结构清晰，维护方便。
• 不用在根目录硬编码深层路径，避免路径错误。
• 可以灵活控制模块之间的依赖关系，比如在根目录链接多个子模块：

add_executable(MyApp main.cc)
target_link_libraries(MyApp PRIVATE WithModule)

关于包含目录的优化建议 #

不要直接写"."或"./nested/folder/with/"这类相对路径，改用${CMAKE_CURRENT_SOURCE_DIR}（当前CMakeLists.txt所在目录的绝对路径），避免因执行cmake的工作目录不同导致路径错误。同时区分PUBLIC和PRIVATE：

• PUBLIC：该目录需要暴露给链接此库的其他目标使用。
• PRIVATE：仅当前库内部使用，无需对外暴露。

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