如何通过CMakeLists.txt让RapidJSON头文件在C++项目全目录可访问

核心思路：用CMake目标导向的依赖传递 #

要让RapidJSON的头文件能被项目所有目录（包括库的include目录）访问，关键是通过CMake的目标属性传递依赖，而非手动添加文件或路径。以下是分步配置：

1. 根目录CMakeLists.txt #

确保正确找到RapidJSON包，并引入子项目：

cmake_minimum_required(VERSION 3.20)
project(YourProject)

# 集成vcpkg（若通过toolchain文件启动CMake，此步骤可省略，否则需确保vcpkg包能被find_package识别）
find_package(RapidJSON REQUIRED)

# 添加子模块
add_subdirectory(apps)
add_subdirectory(cpp-library)

2. cpp-library/CMakeLists.txt #

这是解决问题的关键：将RapidJSON的包含路径通过PUBLIC属性暴露，让库自身的头文件和依赖该库的目标都能访问：

add_library(cpp-library
    src/testClass1.cpp
    src/testClass2.cpp
    # 不建议把include目录下的头文件添加到这里，这不是标准依赖管理做法
)

# 配置库的包含目录：自身include目录+RapidJSON的目录，都设为PUBLIC
target_include_directories(cpp-library
    PUBLIC
        # 构建时用本地include目录，安装时用系统标准include目录
        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
        $<INSTALL_INTERFACE:include>
        ${RAPIDJSON_INCLUDE_DIRS}
)

# 若使用新版vcpkg，RapidJSON提供了导入目标，可替换上面的INCLUDE_DIRS配置为：
# target_link_libraries(cpp-library PUBLIC RapidJSON::RapidJSON)

3. apps/CMakeLists.txt #

只需链接库，即可自动继承所有依赖：

add_executable(app main.cpp)

target_link_libraries(app PRIVATE cpp-library)

为什么你之前的方法不推荐？ #

把include目录的头文件加到add_library里，只是让CMake将这些头文件标记为库的"源文件"，虽能临时解决编译问题，但不符合CMake依赖管理规范。这种做法无法自动传递依赖给其他目标，项目规模扩大后易导致配置混乱。

额外提示 #

若使用CMake Presets，需在CMakePresets.json中正确指定vcpkg的toolchain路径，确保find_package能顺利找到RapidJSON包。

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