CMake创建接口库引用静态库时头文件无法找到的问题排查

我在一个C项目中使用CMake作为构建工具，想要将现有静态库static_lib.a以接口库形式引入，这样项目各处无需手动添加该库的头文件路径。项目目录结构如下：

project
 |
 |-------> app
 |           |----> include
 |           |       |----> a.h
 |           |
 |           |----> src
 |           |       |----> a.c
 |           |
 |           |----> CMakeLists.txt
 |
 |-------> external
 |           |----> lib
 |           |       |----> static_lib.a
 |           |
 |           |----> include
 |           |       |----> b.h
 |           |
 |           |----> CMakeLists.txt
 |
 |----> CMakeLists.txt

static_lib.a包含编译后的b.c，其中函数void b();在b.h中声明。我在external/CMakeLists.txt中配置了导入静态库b并设置INTERFACE头文件目录：

add_library(b STATIC IMPORTED)

set_target_properties(b PROPERTIES IMPORTED_LOCATION lib/static_lib.a)

target_include_directories(b INTERFACE include)

在app/src/a.c中引用该库：

#include "a.h"
#include "b.h"

void a() {
   b();
}

app/CMakeLists.txt配置：

file(GLOB_RECURSE SOURCES src/a.c)

add_library(app ${SOURCES} )

target_link_libraries(app PRIVATE b)

target_include_directories(app PUBLIC include)

但编译时出现错误：

a.c: fatal error: b.h: No such file or directory
  xx | #include "b.h"

只有在app/CMakeLists.txt中手动添加../external/include到头文件路径才能正常编译，这不符合我希望便捷引入库的需求。

问题原因及解决方案 #

你的接口库配置存在两个关键问题：

1. 相对路径解析错误

set_target_properties中IMPORTED_LOCATION的相对路径是相对于构建目录而非external源目录，CMake无法正确定位static_lib.a；target_include_directories的include相对路径也存在同样的解析问题。

修正external/CMakeLists.txt，用CMAKE_CURRENT_SOURCE_DIR获取当前源目录的绝对路径：

add_library(b STATIC IMPORTED)

# 用绝对路径指定静态库位置
set_target_properties(b PROPERTIES 
    IMPORTED_LOCATION "${CMAKE_CURRENT_SOURCE_DIR}/lib/static_lib.a"
)

# 用绝对路径指定INTERFACE头文件目录
target_include_directories(b INTERFACE "${CMAKE_CURRENT_SOURCE_DIR}/include")

2. 顶层CMakeLists.txt需正确包含子目录

顶层project/CMakeLists.txt必须明确添加external和app子目录，否则b目标无法被app识别：

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 先加载external目录，确保b目标被定义
add_subdirectory(external)
# 再加载app目录
add_subdirectory(app)

验证配置

完成修改后重新构建：

mkdir build && cd build
cmake ..
make

此时app目标通过target_link_libraries(app PRIVATE b)会自动继承b的INTERFACE头文件路径，编译时无需手动添加额外路径。

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