如何使用CMake预编译仅头文件库？

看起来你已经把需要编译的第三方依赖（glm、glad、openal这些）配置得有模有样了，处理仅头文件库其实比你想的更简单——毕竟这类库不需要编译二进制，只要让编译器能找到它们的头文件就行，咱们结合你的项目结构来一步步说：

方法一：直接添加头文件路径（快速上手） #

你的仅头文件库都放在engine/vendor/header_only/include下面对吧？那直接在./engine/CMakeLists.txt里的target_include_directories部分，把这个路径加进去就行：

target_include_directories(engine PUBLIC 
    ${PROJECT_SOURCE_DIR}/include
    # 新增仅头文件库的路径
    ${PROJECT_SOURCE_DIR}/vendor/header_only/include
)

这里用PUBLIC的原因是：如果你的testbed这类需要链接engine的目标也要用到这些仅头文件库的话，CMake会自动把这个路径传递给它们，不用你再去testbed的CMakeLists里重复配置。如果只有engine自己用这些头文件，把PUBLIC改成PRIVATE就好。

方法二：用INTERFACE库管理（更规范的现代CMake做法） #

如果以后你要加更多仅头文件库，或者想让依赖关系更清晰，推荐把仅头文件库声明为CMake的INTERFACE库——这是CMake专门为仅头文件/无二进制的依赖设计的类型。

在./engine/CMakeLists.txt里添加这段代码：

# 定义仅头文件库
add_library(engine_header_deps INTERFACE)
add_library(engine::header_deps ALIAS engine_header_deps)

# 指定库的头文件路径
target_include_directories(engine_header_deps INTERFACE
    ${PROJECT_SOURCE_DIR}/vendor/header_only/include
)

# 把这个仅头文件库链接到你的engine库
target_link_libraries(engine PUBLIC engine::header_deps)

这么做的好处是，你可以把所有仅头文件依赖都归到engine_header_deps这个目标里，以后加新的仅头文件库，只需要在这个目标里追加路径就行；而且依赖关系更明确，别人看你的CMakeLists也能一眼明白哪些是仅头文件依赖。

关于VSCode的IntelliSense配置 #

你之前手动加了engine/vendor/**到includePath，其实只要CMake配置正确，VSCode的C/C++扩展会自动读取CMake生成的编译数据库，自动识别这些头文件路径——以后不用手动维护settings.json里的includePath了，CMake会帮你搞定。

最后记得重新生成CMake缓存（比如在VSCode里按Ctrl+Shift+P选"CMake: Configure"），这样所有配置就会生效啦。

备注：内容来源于stack exchange，提问作者PedroGaya