C++调用Python脚本需嵌入Python解释器,核心步骤包括:配置开发环境并链接对应版本库;调用Py_Initialize()初始化,Py_SetPath()设路径,PyImport_ImportModule()导入模块;用PyObject*封装数据,PyTuple_New()构造参数,PyObject_CallObject()调用函数,转换结果并Py_DECREF()释放;通过PyErr_Occurred()检查错误,Py_FinalizeEx()清理资源。

在C++中调用Python脚本,核心是使用Python官方提供的C API(即Python.h),通过嵌入Python解释器实现混合编程。这不是简单“执行一个.py文件”,而是让C++程序启动并控制Python运行时,加载模块、调用函数、传递数据、获取结果。关键在于环境配置、解释器初始化、对象转换和错误处理。
准备Python开发环境与链接设置
确保已安装Python开发包(如Windows需安装Python官方发行版并勾选“Add Python to PATH”和“Install python.exe for all users”;Linux/macOS通常需安装python3-dev或python3-devel)。编译C++代码时,必须链接Python库:
- Linux:添加
-lpython3.9(版本号按实际调整)和-I/usr/include/python3.9 - macOS:类似,路径可能为
/opt/homebrew/include/python3.9(Homebrew安装) - Windows:链接
python39.lib(对应Python 3.9),头文件路径为PythonXX\include,运行时需确保python39.dll在PATH中
初始化解释器并导入模块
在C++中调用Python前,必须先初始化解释器,并指定Python路径(尤其当Python未全局安装时):
- 调用
Py_Initialize()启动解释器 - 用
Py_SetPythonHome(L"路径")(Windows宽字符)或Py_SetPath()(推荐,支持多路径)指定Python标准库位置 - 使用
PyImport_ImportModule("mymodule")导入目标模块(注意:模块需在Python路径中,或提前用sys.path.append添加)
若模块含中文路径或依赖,建议在C++中先执行一段Python初始化代码(如PyRun_SimpleString("import sys; sys.path.append('...')"))。
立即学习“Python免费学习笔记(深入)”;
调用Python函数并交换数据
C++与Python间不能直接传int/string等原生类型,所有数据必须封装为Python对象(PyObject*):
- 用
PyLong_FromLong(123)、PyUnicode_FromString("hello")构造输入参数 - 用
PyObject_CallObject(func, args)调用函数,args是PyTuple_New()创建的元组 - 返回值也是
PyObject*,可用PyLong_AsLong()、PyUnicode_AsUTF8()等安全转换(务必检查是否为nullptr,表示异常) - 每次创建的
PyObject*用完后应调用Py_DECREF()释放引用,避免内存泄漏
错误处理与解释器清理
Python执行出错时不会抛C++异常,而是设置错误状态,需主动检查:
- 调用
PyErr_Occurred()判断是否有异常;若有,用PyErr_Print()打印到stderr,或用PyErr_Fetch()获取详细信息 - 不要忽略任何Python API调用的返回值——多数函数失败时返回
nullptr - 程序退出前调用
Py_FinalizeEx()(推荐)或Py_Finalize()清理资源;多次调用Py_Initialize()前需确保已正确终了
基本上就这些。不复杂但容易忽略路径、引用计数和错误检查——这三处出问题最多。











