C++调用Python脚本方法详解

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函数并交换数据

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()前需确保已正确终了

基本上就这些。不复杂但容易忽略路径、引用计数和错误检查——这三处出问题最多。