在C++中嵌入Python：Debug模式下导入非标准模块报错

使用pybind11在C++中嵌入Python时，Release模式下可正常导入所有Python模块（包括numpy、自定义wheel库），但Debug模式下仅能导入os、sys等标准模块，导入第三方库时抛出error_already_set异常。

项目结构：

|__ CMakeLists.txt
|__ my_lib/
|      |____ CMakeLists.txt
|      |____ 源文件/头文件
|
|__ lib_pybind11/  # 存放pybind11最新源码
         |______ CMakeLists.txt
         |______ include/
         |           |_____ pybind11/
         |                     |_____ pybind11头文件
         |______ [...]

主CMakeLists.txt关键配置：

project (
  my_proj
  VERSION 0.1
  DESCRIPTION "my_proj"
  LANGUAGES CXX)

set(PYBIND11_INCLUDE_LIB "${PROJECT_SOURCE_DIR}/lib_pybind11/include/pybind11")
set(PYBIND11_INCLUDE_DIR "${PROJECT_SOURCE_DIR}/lib_pybind11/include/")
include_directories(${PYBIND11_INCLUDE_DIR})

add_subdirectory ("src/my_lib")
add_subdirectory ("lib_pybind11")

my_lib目录下CMakeLists.txt关键配置：

set(MYLIB_SRC
     [...cpp文件]
)
set(MYLIB_H
     [...h文件]
)
set(Python_FIND_ABI "OFF" "ANY" "ANY")
find_package(Python3 REQUIRED COMPONENTS Development)

add_library(my_lib ${MYLIB_SRC} ${MYLIB_H})
target_compile_features(my_lib PUBLIC cxx_std_17)
set_target_properties(my_lib PROPERTIES LINKER_LANGUAGE CXX)

target_link_libraries(my_lib PUBLIC Python3::Python pybind11::embed)
target_include_directories(my_lib INTERFACE ${PYBIND11_INCLUDE_LIB})

测试代码：

pybind11::initialize_interpreter();
py::object Channel = py::module_::import("external_lib").attr("Channel");

1. 修复Python ABI匹配问题 #

Debug模式下的C++程序需要链接Python的Debug版本库，当前Python_FIND_ABI "OFF" "ANY" "ANY"的设置会导致CMake可能匹配到Release版本的Python库，引发ABI不兼容。修改my_lib的CMake配置：

# 根据编译模式匹配对应ABI的Python库
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
  set(Python_FIND_ABI "ON" "ON" "ON") # 强制匹配带d后缀的Debug版本库
else()
  set(Python_FIND_ABI "ON" "OFF" "OFF") # Release模式匹配Release版本库
endif()

find_package(Python3 REQUIRED COMPONENTS Development)

2. 安装Python Debug版本 #

Windows默认安装Python时不会包含Debug库（python3xx_d.lib），需要重新安装Python并勾选"Download debug binaries"选项，或从Python官网手动下载对应版本的Debug安装包。

3. 修正pybind11的CMake导入方式 #

无需手动设置pybind11的include目录，直接通过add_subdirectory导入后使用官方提供的目标即可：

• 主CMakeLists.txt修改：

project (
  my_proj
  VERSION 0.1
  DESCRIPTION "my_proj"
  LANGUAGES CXX)

# 先导入pybind11，再添加业务模块
add_subdirectory ("lib_pybind11")
add_subdirectory ("src/my_lib")

• my_lib的CMakeLists.txt移除手动设置的pybind11路径：

# 移除以下两行：
# set(PYBIND11_INCLUDE_LIB "${PROJECT_SOURCE_DIR}/lib_pybind11/include/pybind11")
# target_include_directories(my_lib INTERFACE ${PYBIND11_INCLUDE_LIB})

# 直接使用pybind11::embed目标，自动处理include路径
target_link_libraries(my_lib PUBLIC Python3::Python pybind11::embed)

4. 确保第三方库兼容Debug模式 #

部分Python第三方库（如numpy）的wheel包默认仅包含Release二进制文件，Debug模式下无法加载，可选择：

• 从源码编译Debug版本：pip install numpy --force-reinstall --no-binary :all:
• 临时在Debug模式下指定Release库路径（不推荐，可能存在稳定性问题）：

pybind11::initialize_interpreter(false); // 不自动初始化sys.path
py::module sys = py::module_::import("sys");
// 添加Release版第三方库的安装路径
sys.attr("path").attr("append")("C:\\PythonXX\\Lib\\site-packages");

5. 捕获异常查看详细错误 #

通过捕获异常打印具体错误信息，帮助定位问题：

try {
    pybind11::initialize_interpreter();
    py::object Channel = py::module_::import("external_lib").attr("Channel");
} catch (const pybind11::error_already_set& e) {
    std::cerr << "Python错误详情: " << e.what() << std::endl;
    pybind11::finalize_interpreter();
    return 1;
}

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