如何在C++项目中使用CMake正确添加库并配置头文件搜索路径

你的猜测是对的，确实需要把some_library/include添加到头文件搜索路径中，下面是两种可选的配置方式：

方案1：直接修改根目录CMakeLists.txt（快速适配现有代码） #

直接在原有配置的target_include_directories中新增some_library/include路径即可，修改后的完整代码如下：

cmake_minimum_required(VERSION 3.20)
project(taxonomy)

set(CMAKE_CXX_STANDARD 14)

add_executable(taxonomy main.cpp)
target_include_directories(taxonomy PUBLIC 
    some_library
    some_library/include
)

修改后编译器就能从some_library/include路径下找到subdirectory/someCode.cpp，匹配all.hpp中的引入语句。如果希望简化main函数中的头文件引入写法，也可以直接写#include "all.hpp"，不需要再加前缀路径。

方案2：通过子库配置自动继承路径（更规范的工程化写法） #

如果some_library是独立复用的模块，更推荐在它自己的CMake配置中导出头文件路径，根目录直接链接即可：

1. 编辑some_library/CMakeLists.txt，添加如下内容：

# 因为当前是纯头文件库，用INTERFACE类型即可
add_library(some_library INTERFACE)
# 对外导出include目录作为头文件搜索路径
target_include_directories(some_library INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/include)

2. 编辑根目录CMakeLists.txt，引入子库并链接：

cmake_minimum_required(VERSION 3.20)
project(taxonomy)

set(CMAKE_CXX_STANDARD 14)

# 引入子库目录
add_subdirectory(some_library)

add_executable(taxonomy main.cpp)
# 链接子库，自动继承它配置的头文件搜索路径
target_link_libraries(taxonomy PUBLIC some_library)

这种方式后续如果some_library新增依赖或者调整路径，只需要修改它自己的CMake配置，不需要改动根目录逻辑。

注意事项 #

常规C++工程不建议直接引入.cpp文件，除非是单头文件库、模板实现分离这类特殊场景，普通的业务代码建议把.cpp文件直接添加到add_executable或add_library的源文件列表中参与编译。

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