CMake中PkgConfig模块获取INCLUDE_DIRS缺失目录，终端pkg-config正常

简短版（TL;DR） #

你遇到的核心问题大概率是**PKG_CONFIG_PATH环境变量设置的时机不对**——你是在加载PkgConfig模块之后才设置的路径，导致CMake的PkgConfig实例没读到正确的搜索路径。调整顺序后应该能解决，下面是详细排查步骤：

详细分析与解决步骤 #

1. 最可能的根源：环境变量设置顺序错误 #

看你的CMake代码：

find_package(PkgConfig REQUIRED) 
set(ENV{PKG_CONFIG_PATH} "/usr/local/opt/thelibrary/pkgconfig:$ENV{PKG_CONFIG_PATH}")
pkg_check_modules(THELIBRARY thelibrary)

这里的问题是：find_package(PkgConfig)会在加载时初始化pkg-config的搜索路径，后续修改PKG_CONFIG_PATH不会被已加载的PkgConfig模块重新读取。

你需要把环境变量的设置移到find_package(PkgConfig)之前：

# 先设置pkg-config的搜索路径，再加载模块
set(ENV{PKG_CONFIG_PATH} "/usr/local/opt/thelibrary/pkgconfig:$ENV{PKG_CONFIG_PATH}")
find_package(PkgConfig REQUIRED)
# 加上REQUIRED，确保找不到库时CMake直接报错，避免静默失败
pkg_check_modules(THELIBRARY REQUIRED thelibrary)

2. 验证环境变量是否生效 #

修改后，先确认CMake里的PKG_CONFIG_PATH是否正确，在CMakeLists里加一行打印：

MESSAGE( STATUS "Current PKG_CONFIG_PATH: $ENV{PKG_CONFIG_PATH}" )

运行CMake时看输出，确认/usr/local/opt/thelibrary/pkgconfig确实在路径列表里。

3. 检查.pc文件的正确性 #

如果调整顺序后还是有问题，打开/usr/local/opt/thelibrary/pkgconfig/thelibrary.pc文件，检查以下内容：

• 确认Cflags字段包含了-I/opt/thelibrary/include，比如：

  prefix=/opt/thelibrary
  includedir=${prefix}/include
  Cflags: -I${includedir} -I/opt/auxlib1/include -I/opt/auxlib2/include
  

• 如果用了变量（比如${includedir}），确认prefix和includedir的路径是正确的，没有相对路径错误。

4. 对比CMake和终端的pkg-config调用结果 #

有时候CMake调用的pkg-config和终端里的不是同一个，你可以在CMake里直接执行pkg-config命令，对比结果：

execute_process(
    COMMAND pkg-config thelibrary --cflags
    OUTPUT_VARIABLE RAW_PKG_CONFIG_CFLAGS
    OUTPUT_STRIP_TRAILING_WHITESPACE
)
MESSAGE( STATUS "Raw pkg-config --cflags output: ${RAW_PKG_CONFIG_CFLAGS}" )

如果这个输出和终端里跑pkg-config thelibrary --cflags的结果一致，但THELIBRARY_INCLUDE_DIRS还是缺目录，那可能是CMake的PkgConfig模块解析时的问题——这时候可以直接用RAW_PKG_CONFIG_CFLAGS来手动设置包含目录（作为临时 workaround）：

include_directories(${RAW_PKG_CONFIG_CFLAGS})

5. 注意Ubuntu下的路径差异 #

你提到Mac下正常，Ubuntu下出问题：Mac的Homebrew常用/usr/local/opt存放包，但Ubuntu默认没有这个目录。确认你在Ubuntu下确实把thelibrary的.pc文件放在了/usr/local/opt/thelibrary/pkgconfig，或者改成Ubuntu常用的路径（比如/usr/local/lib/pkgconfig或/usr/local/share/pkgconfig），这样不用手动设置PKG_CONFIG_PATH也能找到。

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