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()
示例代码：
立即学习“Python免费学习笔记（深入）”；
#includeint 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_New 和 PyLong_FromLong 等
- 调用函数：PyObject_CallObject
示例：调用 test.py 中的 add(a, b) 函数
// test.pydef 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开始，逐步增加功能。
