如何在Pybind11中设置默认释放GIL以提升多线程性能？

可以通过两种方式实现默认释放GIL，避免重复编写py::call_guard<py::gil_scoped_release>：

1. 模块级默认调用守卫 #

Pybind11支持为整个模块设置默认的调用守卫，一次配置后所有导出的函数、类方法都会自动应用该守卫。

示例代码：

#include <pybind11/pybind11.h>

namespace py = pybind11;

PYBIND11_MODULE(your_lib, m) {
    // 为模块设置默认调用守卫：进入函数时自动释放GIL
    m.attr("__pybind11_default_guard") = py::cast(py::call_guard<py::gil_scoped_release>());

    // 后续导出的所有函数无需手动添加call_guard
    m.def("calc_sum", [](int a, int b) {
        // 线程安全的C++计算逻辑
        return a + b;
    });

    py::class_<DataProcessor>(m, "DataProcessor")
        .def(py::init<>())
        .def("process_batch", &DataProcessor::processBatch);
}

例外情况处理 #

如果某个特定函数需要保留GIL（例如要操作Python对象、调用Python API），可以单独为它指定py::call_guard<py::gil_scoped_acquire>来覆盖默认设置：

m.def("update_py_list", [](py::list lst, int val) {
    // 操作Python列表，必须持有GIL
    lst.append(val);
}, py::call_guard<py::gil_scoped_acquire>());

2. 自定义导出宏 #

若你需要更灵活的控制（或兼容较旧版本的Pybind11），可以封装自定义宏来简化导出流程：

#include <pybind11/pybind11.h>

namespace py = pybind11;

// 自定义宏：带默认GIL释放的函数导出
#define EXPORT_FUNC(m, name, func) \
    m.def(#name, func, py::call_guard<py::gil_scoped_release>())

// 自定义宏：带默认GIL释放的类方法导出
#define EXPORT_METHOD(cls, name, func) \
    cls.def(#name, func, py::call_guard<py::gil_scoped_release>())

PYBIND11_MODULE(your_lib, m) {
    EXPORT_FUNC(m, calc_product, [](int a, int b) {
        return a * b;
    });

    py::class_<ImageFilter>(m, "ImageFilter")
        .def(py::init<>())
        .EXPORT_METHOD(apply_blur, &ImageFilter::applyBlur);
}

性能说明 #

由于你的库所有函数均为线程安全，默认释放GIL后，Python多线程可以真正并行执行这些C++逻辑——GIL不再是瓶颈，多个线程能同时利用多核CPU资源，最大化多线程性能。

关键注意事项 #

务必确保所有导出的C++代码确实线程安全：没有未受保护的全局共享变量，所有资源访问都有正确的同步机制（如互斥锁、原子操作）。若函数需要操作Python对象，必须显式获取GIL，否则会触发未定义行为。

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