CMakeLists.txt配置Python3.9头文件与库链接失败的解决方法

你当前CMake配置导致Python依赖链接失败的核心原因非常明确：

• 脚本全程没有调用CMake的模块查找Python3.9的开发依赖，末尾引用的${PYTHON_LIBRARIES}是未初始化的空变量，链接阶段根本没有传入Python库的相关参数
• 仅通过硬编码INCLUDE_DIRECTORIES("/usr/include/python3.9")配置了Python的头文件路径，没有配置Python库文件的搜索路径，就算后续手动补写-lpython3.9参数，也可能因为库路径不在搜索范围导致链接失败
• 原本放在include_directories里的/opt/mongo-cxx-driver/lib64是库文件目录，不是头文件目录，属于冗余配置，不影响Python依赖加载，但不符合CMake的路径管理规范

不需要手动硬编码Python的头文件和库路径，直接调用CMake官方的查找模块精确定位Python3.9的所有依赖，替换原有Python相关的配置：

1. 将CMake最低版本要求提升到3.12，这个版本开始的FindPython3模块支持精确匹配Python版本，兼容性更好
2. 增加Python3.9的查找逻辑，指定加载开发头文件、嵌入式库组件
3. 用CMake提供的封装目标替代手动变量拼接，避免空变量导致的链接缺失
4. 把原本错放到头文件路径里的Mongo库目录，调整为链接阶段的搜索路径

修正后的完整CMakeLists.txt参考：

cmake_minimum_required(VERSION 3.12)
set(CMAKE_CXX_STANDARD 11)
add_subdirectory(../dlib dlib_build)
add_executable(testmongo data.cpp)

# 精确匹配Python3.9版本，加载开发头文件、可嵌入的Python库
find_package(Python3 3.9 EXACT COMPONENTS Development Development.Embed REQUIRED)

# 加载Mongo CXX驱动依赖
find_package(libmongocxx REQUIRED)
find_package(libbsoncxx REQUIRED)

# 为testmongo目标绑定独立的头文件搜索路径，替代全局INCLUDE_DIRECTORIES
target_include_directories(testmongo PRIVATE
  ${Python3_INCLUDE_DIRS}
  ${LIBMONGOCXX_INCLUDE_DIR}
  ${LIBBSONCXX_INCLUDE_DIR}
  "/opt/mongo-cxx-driver/include/mongocxx/v_noabi"
  "/opt/mongo-cxx-driver/include/bsoncxx/v_noabi"
  "/opt/mongo-cxx-driver/include/libmongoc-1.0"
  "/opt/mongo-cxx-driver/include/libbson-1.0"
)

# 为链接阶段配置Mongo库的搜索路径
target_link_directories(testmongo PRIVATE "/opt/mongo-cxx-driver/lib64")

# 绑定所有需要链接的库
target_link_libraries(testmongo
  ${LIBMONGOCXX_LIBRARIES}
  ${LIBBSONCXX_LIBRARIES}
  dlib::dlib
  Python3::Python
)

修正后配置的效果和你之前手动执行gcc命令完全一致：CMake会自动定位/usr/include/python3.9作为头文件路径，自动链接libpython3.9.so库文件，不会出现空变量导致的链接缺失问题。

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