C++通过 Py_Initialize实现对Python的嵌入调用

 更新时间:2025年12月30日 08:28:19   作者:天天进步2015  
在现代软件开发中,性能(C++)与灵活性(Python)的结合是许多大型项目的首选方案,本文将带你走进 Python C API 的世界,重点介绍如何通过 Py_Initialize 实现 C++ 对 Python 的嵌入调用,希望对大家有所帮助

在现代软件开发中,性能(C++)灵活性(Python)的结合是许多大型项目的首选方案。无论是游戏引擎(如 Unreal Engine)还是高性能计算工具,通过在 C++ 中嵌入 Python 脚本,可以让用户在不重新编译程序的情况下编写插件或逻辑。

本文将带你走进 Python C API 的世界,重点介绍如何通过 Py_Initialize 实现 C++ 对 Python 的嵌入调用。

为什么要嵌入 Python

  • 脚本化:允许用户自定义逻辑。
  • 快速原型:利用 Python 丰富的库(如 NumPy, SciPy)处理数据,而核心逻辑保持在 C++ 中。
  • 逻辑分离:将频繁变动的业务逻辑放在脚本层,核心底层放在 C++ 层。

核心流程图

在深入代码之前,我们先看下 C++ 调用 Python 的标准生命周期:

第一步:环境配置

要在 C++ 中使用 Python API,你需要:

头文件Python.h(位于 Python 安装目录的 include 文件夹)。

库文件python3x.lib(Windows)或 libpython3x.so(Linux)。

注意:确保你的 C++ 编译位数(x64/x86)与 Python 安装版本一致,否则会报链接错误。

第二步:最简实现:Hello World

我们先从最简单的初始化和运行一段 Python 代码开始。

#include <Python.h>
#include <iostream>

int main() {
    // 1. 初始化 Python 解释器
    Py_Initialize();

    if (!Py_IsInitialized()) {
        std::cerr << "Python 初始化失败!" << std::endl;
        return -1;
    }

    // 2. 执行简单的 Python 语句
    PyRun_SimpleString("print('Hello from Python! I am embedded in C++.')");
    PyRun_SimpleString("import platform; print('Python Version:', platform.python_version())");

    // 3. 释放资源
    Py_Finalize();
    return 0;
}

第三步:进阶——调用 Python 函数并传递参数

在实际项目中,我们通常需要加载一个 .py 文件,并调用其中的特定函数。

1. 准备 Python 脚本 (script.py)

# script.py
def add(a, b):
    print(f"Python 收到参数: {a} 和 {b}")
    return a + b

2. C++ 调用代码

调用过程涉及 Python 对象的引用计数管理,这是最容易出错的地方。

#include <Python.h>
#include <iostream>

int main() {
    Py_Initialize();

    // 将当前路径加入 Python 的搜索路径,否则找不到 script.py
    PyRun_SimpleString("import sys; sys.path.append('.')");

    // 加载模块
    PyObject* pModule = PyImport_ImportModule("script");
    if (pModule) {
        // 获取函数对象
        PyObject* pFunc = PyObject_GetAttrString(pModule, "add");

        if (pFunc && PyCallable_Check(pFunc)) {
            // 创建参数元组 (3, 5)
            PyObject* pArgs = PyTuple_Pack(2, PyLong_FromLong(3), PyLong_FromLong(5));

            // 调用函数
            PyObject* pValue = PyObject_CallObject(pFunc, pArgs);

            if (pValue) {
                std::cout << "C++ 收到结果: " << PyLong_AsLong(pValue) << std::endl;
                Py_DECREF(pValue);
            }
            Py_DECREF(pArgs);
        }
        Py_XDECREF(pFunc);
        Py_DECREF(pModule);
    } else {
        PyErr_Print(); // 打印 Python 错误堆栈
    }

    Py_Finalize();
    return 0;
}

核心 API 详解

函数功能
Py_Initialize()启动 Python 解释器并加载基本模块。
PyRun_SimpleString()执行单行 Python 代码,简单快捷,但无法获取返回值。
PyImport_ImportModule()动态加载一个 .py 模块。
PyObject_GetAttrString()从模块中获取属性(如函数、类)。
PyTuple_Pack()将 C++ 数据打包成 Python 的元组,用于函数传参。
Py_DECREF()减少引用计数。极其重要,否则会导致严重的内存泄漏。

避坑指南(经验总结)

  • 路径问题:Python 解释器默认不搜索 C++ 可执行文件目录。务必使用 sys.path.append('.') 或设置 PYTHONPATH 环境变量。
  • Debug/Release 陷阱:在 Windows 上,如果你编译 C++ 为 Debug 模式,它会尝试寻找 python3x_d.lib。如果你的 Python 环境没有安装调试库,请确保 C++ 使用 Release 模式,或者手动修改宏定义。
  • 引用计数:遵循“谁创建,谁负责”的原则。如果你通过 PyImportPyObject_Get 获得了对象,不用时必须 Py_DECREF
  • 多线程 (GIL):如果你的 C++ 程序是多线程的,且多个线程都要调用 Python,你需要处理 GIL (Global Interpreter Lock)

总结

通过 Py_Initialize 嵌入 Python,为 C++ 程序打开了一扇通往无限库资源的大门。虽然 Python C API 的语法略显繁琐(尤其是内存管理),但它带来的灵活性是无与伦比的。

到此这篇关于C++通过 Py_Initialize实现对Python的嵌入调用的文章就介绍到这了,更多相关C++嵌入调用Python内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 用c语言实现冒泡排序,选择排序,快速排序

    用c语言实现冒泡排序,选择排序,快速排序

    本篇文章是对使用c语言实现冒泡排序,选择排序,快速排序的代码进行了详细的分析介绍,需要的朋友参考下
    2013-05-05
  • 利用C语言实现将格式化数据和字符串相互转换

    利用C语言实现将格式化数据和字符串相互转换

    这篇文章主要为大家详细介绍了2个函数,分别是sprintf和sscanf,可以用来实现将格式化数据和字符串相互转换,感兴趣的小伙伴可以跟随小编一起学习一下
    2023-03-03
  • C++强制转换与智能指针示例详解

    C++强制转换与智能指针示例详解

    这篇文章主要介绍了C++强制转换与智能指针示例,智能指针(Smart Pointer)是一种抽象的数据类型。在程序设计中,它通常是经由类模板来实现,借由模板来达成泛型,借由类别的析构函数来达成自动释放指针所指向的存储器或对象
    2022-11-11
  • C/C++函数参数声明解析int fun() 与 int fun(void) 的区别讲解

    C/C++函数参数声明解析int fun() 与 int fun(void) 的区别讲解

    C++中int fun()和int fun(void)的区别在于函数参数的声明方式,前者默认允许任意参数,而后者表示没有参数,通过清晰的实例源代码,详细解释了它们在函数声明和调用中的不同之处,这篇文章介绍了C/C++函数参数声明int fun()与int fun(void)的差异,需要的朋友可以参考下
    2024-01-01
  • C++11可变参数模板的具体实现

    C++11可变参数模板的具体实现

    C++11引入的可变参数模板是一项非常强大的特性,它极大地提升了模板的扩展性,可变参数模板允许我们定义可以接受任意数量和类型参数的模板,这在处理不定数量参数的场景中非常有用,感兴趣的可以了解一下
    2025-06-06
  • C++获取本地时间常见方法汇总

    C++获取本地时间常见方法汇总

    这篇文章主要介绍了C++获取本地时间的常见方法,帮助大家更好的理解和学习C++,感兴趣的朋友可以了解下
    2020-08-08
  • C语言线性表之双链表详解

    C语言线性表之双链表详解

    这篇文章主要为大家详细介绍了C语言线性表之双链表,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-02-02
  • C++ Boost多线程和并发教程分享

    C++ Boost多线程和并发教程分享

    这篇文章主要介绍了C++ Boost多线程和并发教程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-05-05
  • Qt 鼠标/触屏绘制平滑曲线(支持矢量/非矢量方式)

    Qt 鼠标/触屏绘制平滑曲线(支持矢量/非矢量方式)

    这篇文章主要介绍了Qt 鼠标/触屏绘制平滑曲线(支持矢量/非矢量方式),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-04-04
  • FFmpeg实现音频渐响效果参数值详解

    FFmpeg实现音频渐响效果参数值详解

    这篇文章主要为大家介绍了FFmpeg实现音频渐响效果参数值详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10

最新评论