Pybind11报错：无法用pybind11::error_already_set初始化std::runtime_error

问题原因 #

这个错误通常是头文件包含顺序错误或者IDE静态分析缓存异常导致的：

• Pybind11内部已经封装了Python.h的包含逻辑，手动额外/顺序错误地包含Python.h会触发类型定义冲突，导致异常类型不匹配的错误提示。
• CLion的代码分析缓存可能出现假阳性，实际编译正常但IDE报错。

解决步骤 #

1. 修正头文件包含 #

移除代码中手动添加的<python3.8/Python.h>，修改后的代码如下：

#include <vector>
#include <pybind11/pybind11.h>

namespace py = pybind11;

int add(int x, int y) {
    return x + y;
}

PYBIND11_MODULE(example, m) {
    m.def("example_function", &add, "Bind example function");
 }

2. 清理CLion缓存（如果修改后仍报错） #

如果IDE依然提示错误，执行以下操作：

• 点击顶部菜单栏 File -> Invalidate Caches...
• 选择 Invalidate and Restart，重启IDE后代码分析会重新加载。

3. 检查CMake配置（若使用CMake构建） #

确保CMakeLists.txt中正确配置pybind11，示例配置如下：

cmake_minimum_required(VERSION 3.14)
project(example)

find_package(pybind11 REQUIRED)

pybind11_add_module(example example.cpp)

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