CMake：使用FetchContent引入仅头文件库的传递依赖问题

错误原因 #

1. PRIVATE包含目录的局限性：使用PRIVATE添加${pcg_SOURCE_DIR}/include时，该路径仅对当前模块的编译生效，依赖它的第二个模块无法继承这个包含目录，因此会出现头文件找不到的报错。
2. INTERFACE路径的合规性问题：将路径改为INTERFACE后，${pcg_SOURCE_DIR}是构建目录下的绝对路径，CMake禁止将这类本地构建环境特有的路径放入INTERFACE_INCLUDE_DIRECTORIES属性中——因为INTERFACE属性需要保证可移植性，构建目录路径是临时且环境相关的，无法被其他目标（尤其是跨构建场景）正确解析。

正确做法 #

无需手动添加pcg的包含目录，直接利用FetchContent生成的pcg目标完成依赖传递：

pcg-cpp的官方CMake配置已经定义了pcg这个INTERFACE库，并正确设置了它的INTERFACE_INCLUDE_DIRECTORIES属性。你只需要通过target_link_libraries将pcg链接到第一个模块，CMake会自动处理包含目录的传递：

情况1：第一个模块的公共接口暴露了pcg类型 #

如果第一个模块的公共头文件中使用了pcg的类型或声明，依赖它的第二个模块也需要访问pcg的头文件，此时用PUBLIC关键字链接：

# 替换原来的target_include_directories
target_link_libraries(${LIBRARY_NAME} PUBLIC pcg)

情况2：第一个模块仅内部使用pcg #

如果pcg仅在第一个模块的实现文件中使用，公共接口不涉及任何pcg相关内容，用PRIVATE关键字链接即可：

target_link_libraries(${LIBRARY_NAME} PRIVATE pcg)

若此时第二个模块仍报错，说明你的第一个模块公共接口泄露了pcg依赖，需要修改代码（比如将pcg类型移至实现文件、使用前向声明等）。

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