pybind11单次初始化解释器捕获py::exec异常后程序卡死问题

复用解释器后程序冻结的核心原因有两个：

• 你在C++主线程初始化Python解释器后，主线程默认会持有Python全局解释器锁（GIL），执行Python代码抛出异常时，GIL没有被正确释放，后续GUI消息循环、渲染循环的逻辑如果触发任何Python侧的钩子（包括默认注册的信号处理、内存回收钩子），会因为拿不到GIL直接进入永久等待，表现为程序无响应。
• pybind11::error_already_set异常抛出后，Python解释器的错误标记会一直留在当前线程的状态上下文中，你之前每次执行完就销毁解释器，所有状态会被直接清空不会留后遗症；但复用解释器时如果不主动清除错误标记，后续任何Python API调用都会直接触发未处理错误的保护逻辑，直接挂起线程。

按照以下步骤调整代码即可解决：

1. 解释器仅在程序启动时初始化一次，初始化完成后立刻释放当前持有的GIL，不要让C++ GUI循环全程持有GIL。
2. 每次执行Python命令前主动获取GIL，执行完成（无论成功失败）后立刻释放GIL，保证GUI循环的运行不会被GIL阻塞。
3. 捕获到Python异常打印完日志后，显式清除线程上残留的Python错误状态，不要依赖异常析构的隐式清理逻辑。

对应代码示例：

// main函数启动逻辑中，仅初始化一次解释器
int main() {
    // ... 其他初始化逻辑，比如ImGui上下文、窗口创建
    py::initialize_interpreter();
    // 初始化完成后释放GIL，后续需要执行Python代码时再主动获取
    Py_BEGIN_ALLOW_THREADS;

    // ... 原有主消息循环逻辑

    // 程序退出前再收尾销毁解释器
    Py_END_ALLOW_THREADS;
    py::finalize_interpreter();
    return 0;
}

ImGui侧的输入处理代码修改为：

static std::string in;
if (ImGuiCP::InputText("##InputCommand", &in)) {
    // 执行Python代码前获取GIL
    PyGILState_STATE gil_state = PyGILState_Ensure();
    try {
        py::exec(in);
    } catch (const py::error_already_set &e) {
        std::cout << e.what() << std::endl;
        // 关键：显式清除残留的Python错误标记
        PyErr_Clear();
    }
    // 执行结束后立刻释放GIL，交回给GUI循环使用
    PyGILState_Release(gil_state);
}

注意：上述代码用到的GIL操作宏和错误清除函数是Python C API的原生接口，只要你已经正确引入了pybind11的头文件就可以直接调用，不需要额外引入其他依赖。

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