boost python嵌入_C++嵌入Python的应用Boost.Python

作者：RiverSoul 时间：2026-06-28 来源：正软商城浏览：5

在C++DLL中嵌入Python脚本时，使用Boost.Python将已有C++对象实例经指针包装后注入Python命名空间，实现双向调用。采用no_init阻止Python构造新实例，用ptr()传递实例指针，需注意管理对象生命周期与全局解释器锁，确保跨语言调用安全稳定高效。

本文目录

在C++ DLL中嵌入Python脚本，并让双方能互相调用——这个需求在实际开发中并不少见，但真正做起来，细节往往会卡住不少人。尤其是当你希望C++对象实例能直接暴露给Python，并且Python调用的是该对象的方法，而不是创建新实例时，事情就变得微妙起来了。

先梳理一下大家可能遇到的核心难点。假设已经有了一个C++类 CPythonModule，其中包含一个成员函数 foo（比如打印消息），而Python脚本里也有一个函数 bar。目标很明确：C++调用Python的 bar，同时Python也能调用C++对象里的 foo，并且这个对象是应用程序中已经存在的实例，不是Python临时new出来的副本。

很多人在Boost.Python的文档或教程里走到这一步就卡住了——文档告诉你“用 class_ 注册类”，但怎么把当前实例传过去？怎么避免Python创建新对象导致析构函数被乱调？这些关键环节往往被一笔带过，就像某些教程一样：“然后画出猫头鹰的其他部分”。

先从最基础的模块注册说起

通常，我们会写一个 BOOST_PYTHON_MODULE 来暴露接口。例如：

BOOST_PYTHON_MODULE(PythonModule)
{
    class_("Functions", boost::python::no_init)
        .def("foo", &CPythonModule::foo);
}

这里用 no_init 表示不希望Python自己构造这个类的实例——因为实例已经在C++侧存在了。这个思路是对的，但随之而来的问题是：Python拿到这个类之后，如果直接调用 Functions.foo() 会报错，因为Python需要一个实例才能调用成员函数。

换句话说，需要把现有的C++对象“注入”到Python的命名空间中，而不是让Python自己去创建。关键点在于：要用 ptr() 或者 boost::python::object 来包装已有的实例指针。

如何把当前实例交给Python

假设在C++的某个函数中，已经有一个 CPythonModule 的对象 myModule。下面这段代码展示了如何在初始化Python解释器之后，把这个对象暴露给Python脚本：

Py_Initialize();

// 导入之前注册的模块
boost::python::object main_module = boost::python::import("__main__");
boost::python::object main_namespace = main_module.attr("__dict__");

// 把当前实例包装成一个Boost.Python对象
boost::python::object obj(boost::python::ptr(&myModule));

// 将这个对象注入到Python的全局命名空间中，命名成“functions”
main_namespace["functions"] = obj;

// 现在就可以执行Python脚本了
boost::python::exec_file("script.py", main_namespace, main_namespace);

在Python脚本 script.py 中，直接使用 functions.foo("hello") 即可调用C++对象的成员函数，而且这个对象就是C++侧的那个实例，不会有副本构造和析构的风险。

反过来：C++调用Python函数

这其实更直接。同样在 main_namespace 中，Python脚本定义了一个函数 bar，那么C++侧就可以通过Boost.Python获取并调用它：

boost::python::object bar = main_namespace["bar"];
bar(); // 调用Python的bar函数，可以带参数

注意这里 bar 是在 script.py 中定义的全局函数，不需要类实例。如果希望Python脚本也能调用C++对象的方法，只需要在Python脚本里访问 functions 这个全局变量即可。

几个需要警惕的细节

生命周期管理：使用 boost::python::ptr 传递指针时，Boost.Python 不会接管对象的所有权。这意味着只要C++对象 myModule 在DLL卸载前一直有效，Python侧就能安全访问。如果对象被销毁了，再调用函数就会导致未定义行为。
多线程环境：如果C++和Python运行在不同线程，记得处理好GIL（全局解释器锁）。Boost.Python 提供了一些RAII类来管理锁，比如 py::gil_scoped_acquire。
避免no_init带来的混淆：虽然 no_init 阻止了Python侧的默认构造，但如果你在Python里尝试 Functions()，会抛出异常——这正是我们想要的。