如何在CMake中无需指定头文件路径即可使用库？

你遇到的核心问题是库的CMake配置未将头文件路径传递给依赖它的应用目标，导致应用编译时无法自动定位库的头文件。以下是具体原因和解决办法：

原因说明 #

CMake中target_include_directories的PRIVATE关键字表示该路径仅用于当前目标（你的库）自身编译，不会传递给任何链接该库的其他目标（你的应用）。因此即便应用链接了库，依旧无法获知头文件的位置。

解决步骤 #

1. 修正库的CMake配置 #

修改库的CMakeLists.txt，将头文件路径的作用域从PRIVATE改为PUBLIC（若路径仅需提供给依赖目标，也可使用INTERFACE），同时清理冗余配置：

cmake_minimum_required(VERSION 3.0 FATAL_ERROR)

project(mylibrary)

# 移除全局include_directories，优先使用target级别的配置
# include_directories("/path/to/src")

# add_library无需显式添加.h文件，CMake会自动处理头文件依赖
add_library(mylib SHARED ./foo.cpp)

# 使用PUBLIC，让依赖该库的目标自动继承头文件路径
target_include_directories(mylib PUBLIC "/path/to/src")

# 移除不必要的target_link_directories，库无需链接自身路径
# target_link_directories(mylib PRIVATE "/path/to/src")

set_property(TARGET mylib PROPERTY CXX_STANDARD 17)

2. 优化应用的CMake配置 #

如果库和应用属于同一个CMake项目（比如库是子目录），可直接链接库的目标，无需手动指定库文件路径：

cmake_minimum_required(VERSION 3.0 FATAL_ERROR)

project(myapp)

# 若库是子目录，先添加子目录
# add_subdirectory(path/to/mylibrary)

add_executable(test ./main.cpp)

# 直接链接库的目标，CMake会自动导入头文件路径和库文件路径
target_link_libraries(test PRIVATE mylib)

set_property(TARGET test PROPERTY CXX_STANDARD 17)

如果库是独立编译安装的，推荐在库的CMake中添加安装配置，生成CMake导入文件：

# 在库的CMakeLists.txt末尾添加
install(TARGETS mylib
        EXPORT mylibraryTargets
        LIBRARY DESTINATION lib
        INCLUDES DESTINATION include)

install(EXPORT mylibraryTargets
        FILE mylibraryConfig.cmake
        DESTINATION lib/cmake/mylibrary)

# 同时安装头文件
install(FILES ./foo.h DESTINATION include)

之后应用可通过find_package自动导入库：

cmake_minimum_required(VERSION 3.0 FATAL_ERROR)

project(myapp)

find_package(mylibrary REQUIRED)

add_executable(test ./main.cpp)

target_link_libraries(test PRIVATE mylibrary::mylib)

set_property(TARGET test PROPERTY CXX_STANDARD 17)

关于第三方库的说明 #

正规第三方库都会提供CMake配置文件（如XXXConfig.cmake），使用find_package(XXX REQUIRED)后，CMake会自动处理头文件路径、库路径和链接操作，无需手动指定。若遇到未提供配置文件的第三方库，可能需要手动设置CMAKE_PREFIX_PATH或搭配find_library+target_include_directories处理，但这种情况较为少见。

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