C++可通过Python C API调用Python脚本,需配置Python开发环境并链接库文件,使用Py_Initialize初始化解释器,PyImport_ImportModule加载模块,PyObject_GetAttrString获取函数,PyTuple_New构造参数,PyObject_CallObject执行函数,最后Py_Finalize释放资源,注意内存管理和GIL线程安全。

在C++项目中调用Python脚本,可以借助Python官方提供的C API来实现。这种方法允许你在C++程序中嵌入Python解释器,从而直接执行Python代码、调用函数或传递参数。下面介绍具体实现步骤和注意事项。
配置开发环境
要使用Python C API,首先需要确保系统中安装了Python,并且包含头文件和库文件。
- Windows:推荐使用Python官方发行版或Anaconda,注意设置PYTHON_INCLUDE和PYTHON_LIB路径。
- Linux/macOS:通常可通过包管理器安装python3-dev或python3-devel。
- 在编译时链接Python库,例如g++中添加:-I/usr/include/python3.x -lpython3.x(根据版本调整)。
基本调用流程
C++通过Python.h头文件调用Python脚本,主要步骤如下:
- 初始化Python解释器:Py_Initialize()。
- 执行Python代码:使用PyRun_SimpleString()运行内联代码或加载脚本文件。
- 导入并调用脚本中的函数:通过PyImport_ImportModule获取模块,再用PyObject_GetAttrString获取函数对象。
- 传参与接收返回值:使用PyTuple_New、PyLong_FromLong等构造参数,调用PyObject_CallObject执行函数。
- 结束时调用Py_Finalize()释放资源。
示例代码:调用test.py中的add函数
假设有一个test.py:
立即学习“Python免费学习笔记(深入)”;
def add(a, b):
return a + b
C++调用代码片段:
#include#include int main() { Py_Initialize(); PyObject *pName = PyUnicode_DecodeFSDefault("test"); PyObject *pModule = PyImport_Import(pName); if (!pModule) { std::cerr << "无法加载模块" << std::endl; Py_Finalize(); return -1; } PyObject *pFunc = PyObject_GetAttrString(pModule, "add"); if (!pFunc || !PyCallable_Check(pFunc)) { std::cerr << "无法找到函数或不可调用" << std::endl; Py_Finalize(); return -1; } PyObject *pArgs = PyTuple_New(2); PyTuple_SetItem(pArgs, 0, PyLong_FromLong(5)); PyTuple_SetItem(pArgs, 1, PyLong_FromLong(3)); PyObject *pResult = PyObject_CallObject(pFunc, pArgs); long result = PyLong_AsLong(pResult); std::cout << "结果:" << result << std::endl; Py_DECREF(pName); Py_DECREF(pModule); Py_DECREF(pFunc); Py_DECREF(pArgs); Py_DECREF(pResult); Py_Finalize(); return 0; }
常见问题与建议
实际使用中需注意以下几点:
- 确保Python环境路径正确,避免“找不到模块”错误。
- 所有创建的PyObject指针使用后应适当减引用(Py_DECREF),防止内存泄漏。
- 调试时可先用PyRun_SimpleString("print('hello')")测试环境是否正常。
- 若Python脚本依赖第三方库(如numpy),需保证该环境已安装相应包。
- 多线程环境下需处理GIL(全局解释器锁),必要时调用PyEval_InitThreads()。
基本上就这些。只要配置好环境并遵循API规范,C++调用Python脚本并不复杂,但细节容易出错,建议封装成工具类便于复用。










