C++调用Python脚本需嵌入解释器,核心是初始化、传参、捕获输出与正确清理。须安装对应Python开发包,用PyRun_SimpleFileEx运行脚本(需绝对路径),或封装函数后通过PyImport_ImportModule等API安全交互,并注意多线程、字符串编码及动态库依赖。

用C++调用Python脚本,核心是嵌入Python解释器,不是简单“执行命令行”。关键在初始化解释器、传递参数、捕获输出、正确清理——否则容易崩溃或内存泄漏。
一、前提准备:确保Python开发环境可用
必须安装对应版本的Python开发包(含头文件和链接库):
• Linux:安装 python3-dev(如 sudo apt install python3.10-dev)
• macOS:用Homebrew安装Python时默认带头文件,检查 /opt/homebrew/include/python3.x/
• Windows:推荐用官方Python安装包(勾选“Add Python to PATH”和“Download debug symbols”),并确认 python3x.lib 和 Python.h 可被找到
二、基础调用:运行.py文件并传参
使用 PyRun_SimpleFileEx() 最直接。注意:需先初始化解释器,且脚本路径必须是绝对路径。
示例C++代码片段:
// 初始化(仅一次)
Py_Initialize();
PyRun_SimpleString("import sys");
// 添加当前目录到Python路径(让import生效)
PyRun_SimpleString("sys.path.append('./')");
// 打开并执行脚本
FILE* fp = fopen("script.py", "r");
if (fp) {
PyRun_SimpleFileEx(fp, "script.py", 1);
fclose(fp);
}
// 清理
Py_Finalize();
三、安全交互:传参 + 捕获输出 + 错误处理
直接运行脚本无法获取返回值。更健壮的做法是:把Python逻辑封装成函数,用C++调用它,并重定向sys.stdout来捕获输出。
立即学习“Python免费学习笔记(深入)”;
建议步骤:
- 在Python脚本中定义一个接受参数、返回结果的函数(如
def calc(a, b): return a + b) - C++中用
PyImport_ImportModule()导入模块,再用PyObject_GetAttrString()获取函数对象 - 用
PyTuple_New()和PyLong_FromLong()等构造参数元组 - 调用
PyObject_CallObject(),检查返回值是否为NULL(表示Python异常) - 调用
PyErr_Print()输出错误堆栈(调试必备)
四、实际避坑提醒
• 多线程下必须调用 PyEval_InitThreads()(Python 3.7+已自动处理,但旧版本需手动)
• 不要用 system("python script.py"):无法传参、无法捕获结果、启动慢、跨平台差
• Python字符串是UTF-8,C++中用 PyUnicode_AsUTF8() 安全转换,别直接强转 char*
• 脚本里避免 exit() 或 os._exit(),会终止整个C++进程
• 发布时记得打包对应版本的 python3.x.dll(Windows)或 libpython3.x.so(Linux)
基本上就这些。不复杂但容易忽略细节——尤其初始化顺序和资源释放。跑通第一个“Hello from Python”之后,后续扩展接口、传结构体、回调C++函数,都是顺延逻辑。











