CMake 3.10.1中CPack生成归档文件丢失接口包含目录问题排查

针对你用CMake 3.10.1 + CPack生成归档时，接口包含目录缺失的问题，结合这个版本的特性，我整理了几个最可能的原因：

1. 缺少显式的include目录安装规则 #

target_include_directories(... PUBLIC ...)只是告诉CMake在构建阶段该如何找到头文件，但CPack是基于install()指令安装到指定目录的内容来打包的。如果你的CMakeLists.txt里没有为include目录添加安装规则，这些头文件根本不会被安装，自然不会出现在归档里。

你需要添加类似这样的指令：

# 安装inc目录下的所有头文件到安装路径的include目录
install(DIRECTORY inc/ DESTINATION include)

或者如果你的库是INTERFACE类型，也可以用：

install(TARGETS your_library
        EXPORT your_library-targets
        INCLUDES DESTINATION include)

INCLUDES DESTINATION会把接口包含目录关联到安装路径，但注意在CMake 3.10里这个选项需要配合EXPORT一起生效。

2. CMake 3.10.1的版本局限性 #

CMake 3.10属于比较老旧的版本，早期CPack对目标的INTERFACE属性支持并不完善。比如，它可能不会自动识别INTERFACE_INCLUDE_DIRECTORIES对应的目录并将其纳入安装/打包流程，必须手动通过install(DIRECTORY)来指定。

如果条件允许，升级到更高版本的CMake（比如3.14+）可能会解决这个问题，因为后续版本对CPack和目标属性的联动支持做了很多优化。

3. 接口包含目录的路径设置问题 #

如果你的target_include_directories里用的是相对路径，但没有正确设置CMAKE_INSTALL_PREFIX或者安装时的路径上下文，可能导致CMake无法正确定位到这些目录进行安装。

比如，如果你用的是target_include_directories(your_lib PUBLIC inc)，确保在执行cmake --install（或者make install）时，CMake能正确找到inc目录，并且install(DIRECTORY)指令里的路径是正确的相对路径。

4. 导出配置与安装的联动问题 #

如果你的库是通过export(TARGETS ...)生成导出文件的，要确保导出配置和安装的include目录路径一致。比如，在install(EXPORT ...)时，有没有指定相关属性使得导出的目标能正确关联到安装后的include目录？不过这个更多是影响其他项目导入时的路径，而非归档本身的内容，但如果安装规则缺失的话也会间接导致问题。

总结一下，最常见的原因是没有为include目录添加显式的install规则，先检查你的CMakeLists.txt里有没有相关指令，这应该是首要排查点。

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