c++ 怎么调用Python脚本_c++与Python交互调用方法解析

C++通过Python C API调用Python脚本,需初始化解释器、执行代码或调用函数、最后清理资源。1. 使用Py_Initialize()启动,PyRun_SimpleString()执行语句,Py_Finalize()结束;2. 调用具体函数需导入模块PyImport_ImportModule,获取函数PyObject_GetAttrString,构建参数元组并调用PyObject_CallObject,如调用test.py中add函数传参5和3得结果8;3. 编译时需链接Python库并包含头文件路径,Linux用-I和-l指定路径与库,Windows配置include和libs目录,确保运行时找到DLL;4. 注意版本匹配、GIL线程安全、异常检查PyErr_Occurred()、引用计数内存管理及sys.path模块搜索路径设置。掌握这些可实现高效集成,建议封装工具类并逐步调试。

在实际开发中,C++与Python的交互非常常见,尤其是在需要高性能计算(C++)与快速开发、脚本灵活性(Python)结合的场景。C++调用Python脚本的核心方式是通过Python官方提供的C API。下面介绍具体实现方法和注意事项。

1. 使用Python C API直接调用脚本

Python提供了C语言接口(Python.h),允许C++程序嵌入Python解释器,从而执行.py文件或调用函数。

基本步骤如下:

  • 初始化Python解释器:调用Py_Initialize()
  • 执行Python代码:使用PyRun_SimpleString()或加载脚本文件
  • 调用具体函数:通过模块和函数对象获取并调用
  • 清理资源:调用Py_Finalize()

示例代码:

#include
int main() {
    Py_Initialize();
    if (!Py_IsInitialized()) return -1;

    // 执行一个简单的Python语句
    PyRun_SimpleString("print('Hello from Python!')");

    // 加载并执行脚本文件
    FILE* fp = fopen("test.py", "r");
    if (fp) {
        PyRun_SimpleFile(fp, "test.py");
        fclose(fp);
    }

    Py_Finalize();
    return 0;
}

2. 调用Python函数并传递参数

更实用的方式是从C++调用Python脚本中的特定函数,并传入参数、获取返回值。

操作流程:

  • 导入Python模块:PyImport_ImportModule
  • 获取函数对象:PyObject_GetAttrString
  • 构建参数元组:PyTuple_NewPyLong_FromLong
  • 调用函数:PyObject_CallObject

示例:调用 test.py 中的 add(a, b) 函数

// test.py
def add(a, b):
    return a + b

// C++ 代码片段
Py_Initialize();
PyObject pModule = PyImport_ImportModule("test");
PyObject
pFunc = PyObject_GetAttrString(pModule, "add");

if (PyCallable_Check(pFunc)) {
    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);
    printf("Result: %ld\n", result);
}

3. 编译与环境配置

成功编译需要正确链接Python库并包含头文件路径。

Linux下编译命令示例:

g++ call_python.cpp -o call_python \
    -I/usr/include/python3.x \
    -lpython3.x

Windows(使用MinGW或MSVC):

  • 包含目录添加:Python安装路径下的include文件夹
  • 库目录添加:libs文件夹(如 python39.lib)
  • 确保运行时能找到 pythonXX.dll

4. 注意事项与常见问题

实际使用中需要注意以下几点:

  • 确保Python版本与链接库一致(如Python 3.8对应 libpython3.8.so)
  • 多线程环境下需处理GIL(全局解释器锁)
  • 异常处理:调用后检查PyErr_Occurred()
  • 内存管理:注意Py_DECREF()释放引用,避免泄漏
  • 脚本路径问题:可使用sys.path.append添加模块搜索路径

基本上就这些。掌握Python C API后,C++调用Python脚本并不复杂,但细节容易出错,建议封装成工具类便于复用。调试时可先从简单print开始,逐步增加功能。