VS旧C++项目适配CMake：多子目标头文件定义与复用咨询

1. 目录结构下的CMake配置组织 #

按照你现有的目录结构，采用根目录CMakeLists.txt统筹+子目录CMakeLists.txt独立管理的方式最合理：

根目录CMakeLists.txt（核心统筹） #

负责全局配置，无需关心子项目的具体源码，只需要完成以下操作：

1. 指定CMake最低版本要求（根据项目实际需求选择，比如3.16）
2. 设置项目名称与C++标准版本
3. 声明全局公共头文件目录（对应根目录include）
4. 添加所有子目录（各库目录、main可执行文件目录）

示例代码：

cmake_minimum_required(VERSION 3.16)
project(OldCppProject)

# 设置C++标准，根据项目实际版本调整
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 声明全局公共头文件目录（后续子项目可直接复用）
include_directories(${PROJECT_SOURCE_DIR}/include)

# 添加子目录，顺序不影响CMake自动处理依赖
add_subdirectory(lib1)
add_subdirectory(lib2)
add_subdirectory(main)

子目录CMakeLists.txt（独立管理） #

每个库目录（lib1、lib2）和main目录的CMakeLists.txt只需要专注自身的编译配置：

• 库目录：生成静态/动态库，指定自身源码文件
• main目录：生成可执行文件，链接所需的库

示例（lib1的CMakeLists.txt）：

# 收集lib1下的所有源码文件（可根据实际情况手动指定）
file(GLOB LIB1_SRC *.cpp *.cc)

# 生成静态库，名称为lib1（Windows下会生成lib1.lib，Linux下是liblib1.a）
add_library(lib1 STATIC ${LIB1_SRC})

# 如果lib1依赖其他库（比如lib2），可以在这里添加链接
# target_link_libraries(lib1 PRIVATE lib2)

示例（main目录的CMakeLists.txt）：

# 收集main下的源码文件
file(GLOB MAIN_SRC *.cpp)

# 生成可执行文件
add_executable(main_app ${MAIN_SRC})

# 链接所需的库
target_link_libraries(main_app PRIVATE lib1 lib2)

2. 复用根目录include下的头文件 #

针对你当前项目直接通过文件名包含头文件的情况，有两种可靠方式确保子项目能正确找到头文件：

方式一：全局声明（简单直接，适合旧项目迁移） #

在根目录CMakeLists.txt中使用include_directories(${PROJECT_SOURCE_DIR}/include)，这条命令会将指定目录添加到所有后续目标的头文件搜索路径中，这样子项目的代码里#include "xxx.h"就能直接找到根目录include下的文件，无需修改现有代码。

方式二：目标级声明（现代CMake推荐，更灵活） #

如果希望更精细化控制头文件的可见性（比如只让特定库/可执行文件访问），可以在子项目的CMakeLists.txt中使用target_include_directories：

• 对于库：

add_library(lib1 STATIC ${LIB1_SRC})
# PUBLIC表示该库的依赖项也能继承这个头文件路径
target_include_directories(lib1 PUBLIC ${PROJECT_SOURCE_DIR}/include)

• 对于可执行文件：

add_executable(main_app ${MAIN_SRC})
target_include_directories(main_app PRIVATE ${PROJECT_SOURCE_DIR}/include)
target_link_libraries(main_app PRIVATE lib1 lib2)

这种方式的优势是不会污染全局搜索路径，符合现代CMake的最佳实践，后续扩展项目时更清晰。

注意：如果根目录include下有多层子目录，只要代码里的#include路径是正确的（比如#include "subdir/xxx.h"），以上两种方式都能正常识别，无需额外配置。

内容的提问来源于stack exchange，提问作者Kérdezősködő Indián