如何拆分根CMakeLists.txt为各子目录独立文件并整合为整体CMake项目？

阿华AIGC实验室

2026-5-22

当然可行！这是CMake项目模块化的最佳实践之一

绝对没问题，把各个子模块的CMake配置拆分到各自目录的CMakeLists.txt里，不仅能让根目录的配置变得清爽，还能让每个模块的职责更清晰，后续维护、复用模块都方便很多。我给你一步步拆解实现方式：

1. 改造根目录的`CMakeLists.txt`

根目录只保留项目的全局配置，以及引入子模块的命令，把原来和lib/proj/test相关的具体配置全部移除。示例如下：

cmake_minimum_required(VERSION 3.16) # 根据你的需求调整最低版本
project(Project2 LANGUAGES CXX)

# 设置全局C++标准（也可以在子目录单独配置）
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 引入三个子模块，顺序可以根据依赖关系调整（比如proj依赖lib，lib要先引入）
add_subdirectory(lib)
add_subdirectory(proj)
add_subdirectory(test)

2. 编写`lib`目录的`CMakeLists.txt`

lib是库模块，我们需要创建一个库目标，并管理它的头文件和源文件：

# 创建静态库（如果需要动态库，把STATIC换成SHARED）
add_library(Project2Lib STATIC)

# 配置头文件搜索路径：
# - PUBLIC：让依赖这个库的模块（比如proj、test）也能访问include目录
# - PRIVATE：只有lib自己能访问src目录的头文件（如果有的话）
target_include_directories(Project2Lib
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/include
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}/src
)

# 添加库的源文件和需要暴露的头文件（方便IDE识别）
target_sources(Project2Lib
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}/src/lib_utils.cpp
        ${CMAKE_CURRENT_SOURCE_DIR}/src/core_logic.cpp
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/include/lib_utils.h
        ${CMAKE_CURRENT_SOURCE_DIR}/include/core_logic.h
)

这里的Project2Lib是库的目标名称，后续其他模块可以通过这个名称来链接它。

3. 编写`proj`目录的`CMakeLists.txt`

proj作为主程序模块，依赖lib的库，我们需要创建可执行目标并链接库：

# 创建主程序可执行文件
add_executable(Project2Main)

# 配置主程序的头文件路径（只给自己用，所以用PRIVATE）
target_include_directories(Project2Main
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}/include
        ${CMAKE_CURRENT_SOURCE_DIR}/src
)

# 添加主程序的源文件
target_sources(Project2Main
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}/src/main.cpp
        ${CMAKE_CURRENT_SOURCE_DIR}/src/app_logic.cpp
)

# 链接依赖的lib库
target_link_libraries(Project2Main
    PRIVATE
        Project2Lib
)

4. 编写`test`目录的`CMakeLists.txt`

test作为测试模块，同样依赖lib，创建测试可执行文件并链接库即可：

# 创建测试可执行文件
add_executable(Project2Tests)

# 配置测试程序的头文件路径
target_include_directories(Project2Tests
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}/include
        ${CMAKE_CURRENT_SOURCE_DIR}/src
)

# 添加测试源文件
target_sources(Project2Tests
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}/src/test_core_logic.cpp
        ${CMAKE_CURRENT_SOURCE_DIR}/src/test_lib_utils.cpp
)

# 链接依赖的lib库
target_link_libraries(Project2Tests
    PRIVATE
        Project2Lib
)

# 如果用了测试框架（比如Google Test），可以在这里补充配置：
# find_package(GTest REQUIRED)
# target_link_libraries(Project2Tests PRIVATE GTest::GTest GTest::Main)
# include(GoogleTest)
# gtest_discover_tests(Project2Tests)

几个关键注意点

路径兼容性：全程用CMAKE_CURRENT_SOURCE_DIR来引用当前目录，避免硬编码绝对路径，保证项目在不同环境下都能正常构建。
目标可见性：子目录里创建的目标（比如Project2Lib）在根目录执行add_subdirectory后会变成全局可见，所以proj和test可以直接通过目标名称链接。
权限控制：PUBLIC/PRIVATE的区别要搞清楚——PUBLIC会把设置传递给依赖当前目标的其他模块，PRIVATE只作用于当前目标。
全局配置：如果有全局的编译选项（比如警告等级）、宏定义，可以放在根目录的CMakeLists.txt里，用add_compile_options或者target_compile_definitions统一设置。