### C++ 调用 Python 函数的示例代码 在 C++ 中调用 Python 函数，可以使用嵌入式 Python API。以下是一个完整的示例代码，展示如何通过 Python C API 在 C++ 中调用一个简单的 Python 函数[^3]。 ```cpp #include <Python.h> #include <iostream> int main() { // 初始化 Python 解释器 Py_Initialize(); // 设置 Python 文件路径（如果需要） PyRun_SimpleString("import sys"); PyRun_SimpleString("sys.path.append('./')"); // 将当前目录添加到模块搜索路径 // 导入 Python 模块 PyObject* pName = PyUnicode_FromString("example"); // 假设有一个名为 example.py 的文件 PyObject* pModule = PyImport_Import(pName); if (!pModule) { PyErr_Print(); std::cerr << "无法导入模块" << std::endl; return -1; } // 获取 Python 函数 PyObject* pFunc = PyObject_GetAttrString(pModule, "add"); // 假设 example.py 中有一个 add 函数 if (!PyCallable_Check(pFunc)) { std::cerr << "获取函数失败或不是可调用对象" << std::endl; return -1; } // 准备参数 PyObject* pArgs = PyTuple_Pack(2, PyLong_FromLong(5), PyLong_FromLong(3)); // 调用 Python 函数 PyObject* pResult = PyObject_CallObject(pFunc, pArgs); if (pResult == NULL) { PyErr_Print(); std::cerr << "调用函数失败" << std::endl; return -1; } // 提取结果 long result = PyLong_AsLong(pResult); std::cout << "C++ 中调用 Python 函数的结果: " << result << std::endl; // 清理资源 Py_XDECREF(pResult); Py_XDECREF(pArgs); Py_XDECREF(pFunc); Py_XDECREF(pModule); Py_DECREF(pName); // 关闭 Python 解释器 Py_Finalize(); return 0; } ``` ### 注意事项 - 在上述代码中，`example.py` 是一个假设的 Python 文件，其中包含一个名为 `add` 的函数[^3]。该函数接受两个整数参数并返回它们的和。 - 使用 `Py_Initialize()` 和 `Py_Finalize()` 分别初始化和关闭 Python 解释器。 - 如果在多线程环境中调用 Python 代码，则需要确保全局解释器锁 (GIL) 的正确管理[^3]。例如，在执行 Python 代码之前调用 `PyGILState_Ensure()`，并在完成后调用 `PyGILState_Release()`。 ### 数据类型转换 在 C++ 和 Python 之间传递数据时，可能需要进行类型转换。以下是一些常见的类型转换方法[^3]： | C++ 类型 | Python API 创建函数 | Python 类型到 C++ 提取函数 | |----------------|----------------------------------|-----------------------------------| | `int` | `PyLong_FromLong(42)` | `PyLong_AsLong(py_obj)` | | `double` | `PyFloat_FromDouble(3.14)` | `PyFloat_AsDouble(py_obj)` | | `std::string` | `PyUnicode_FromString("hello")` | `PyUnicode_AsUTF8(py_obj)` | ### 错误处理 在调用 Python 函数时，可能会遇到各种错误。以下是常见问题及其解决方案[^3]： 1. **编译错误：`Python.h not found`** - 确保头文件路径已正确配置。Linux/macOS 用户可以通过 `-I` 参数指向 Python 的 include 目录，Windows 用户则需要在 Visual Studio 中设置“附加包含目录”。 2. **运行时错误：`Fatal Python error: initfsencoding`** - 确保环境变量 `PYTHONHOME` 正确指向 Python 安装根目录。或者在代码中显式设置路径： ```cpp Py_SetPythonHome(L"C:\\Python310"); ``` 3. **模块导入失败：`ModuleNotFoundError`** - 确保模块路径已添加到 `sys.path` 或环境变量 `PYTHONPATH` 中： ```bash export PYTHONPATH="/your/custom/path:$PYTHONPATH" ```