CMake导入第三方库时include目录未传播的问题排查与解决

你的问题出在导入库的INTERFACE属性传播机制以及CMake的链接设置细节上，我们一步步来拆解：

核心原因 #

你已经为nana_lib设置了INTERFACE_INCLUDE_DIRECTORIES，但CMake没有将这个包含目录传递给camera_calib_exe，主要有两个关键问题：

1. 旧版本CMake的默认链接行为：在CMake 3.9.2中，当你使用target_link_libraries(camera_calib_exe nana_lib)而不指定PUBLIC/INTERFACE时，对于可执行目标默认是PRIVATE链接。虽然理论上PRIVATE链接仍会让可执行目标获取库的INTERFACE_INCLUDE_DIRECTORIES，但旧版本CMake对导入静态库的属性传递存在细微兼容性问题，导致包含目录未生效。

2. 属性设置方式的兼容性：使用set_property直接设置INTERFACE_INCLUDE_DIRECTORIES虽然语法正确，但不如target_include_directories直观，后者在处理导入目标时的兼容性和可读性更好。

解决方案 #

推荐采用第一种规范的修复方式，第二种作为临时替代方案：

方案一：规范设置目标属性与链接关键字 #

1. 修改/nana/CMakeLists.txt，将设置包含目录的代码替换为CMake推荐的target_include_directories：

# 替换原来的set_property行
target_include_directories(nana_lib INTERFACE ${PROJECT_SOURCE_DIR}/include)

这是官方推荐的设置目标INTERFACE属性的方式，比直接操作PROPERTY更可靠。

2. 修改根目录CMakeLists.txt，在target_link_libraries中明确指定PUBLIC：

target_link_libraries(camera_calib_exe PUBLIC nana_lib)

明确指定PUBLIC会强制CMake将nana_lib的所有INTERFACE属性（包括包含目录）应用到camera_calib_exe上，彻底避免旧版本CMake的默认行为问题。

方案二：手动添加包含目录（临时 workaround） #

如果不想调整链接方式，也可以直接在根目录CMakeLists.txt中手动添加nana的头文件目录：

target_include_directories(camera_calib_exe PRIVATE 
    ${PROJECT_SOURCE_DIR}/include
    ${PROJECT_SOURCE_DIR}/nana/include  # 手动引入nana的头文件路径
)

但这种方式不够优雅，当nana的路径变化时需要手动修改，维护性较差。

额外验证点 #

请确保你的文件结构符合预期：

• 根目录/nana/include下确实存在nana/gui.hpp、nana/gui/widgets/label.hpp等头文件
• 静态库文件nana_v141_Debug_x64.lib、nana_v141_Release_x64.lib确实位于/nana/lib目录下

完成上述修改后，CMake就能正确识别nana的头文件目录，编译错误应该会消失。

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