在C++非main函数中调用Python模块的实现方案问询

我需要在C++中调用Python模块，但查到的示例都是在main函数里执行Py_Initialize()、Py_FinalizeEx()这类操作。我负责的是大型系统里的一个子模块，没法访问main函数，只能写一个会被多次调用的函数。如果每次调用都初始化解释器、导入模块，性能肯定不行，该怎么处理Python的初始化和清理？我想了两种伪代码思路，不确定能不能行：

思路一：首次调用初始化+退出时清理 #

void my_func(void) {
  if (my_func_is_called_for_the_first_time()) {
    Py_Initialize();
    module = load_python_module();
    etc_related_to_init_stuff();
  }
  if (exiting_program()) { // 类似Python的atexit功能，暂时不知道怎么实现
    clean_everything_related_to_python_and_the_module();
    Py_FinalizeEx();
  }
  // 此处为调用Python模块的业务代码...
}

思路二：全局单例类封装 #

#include <Python.h>

class MyPackage {
public:
  MyPackage() {
    Py_Initialize();
    module = load_python_module();
    // 执行其他初始化操作
  }
  
  ~MyPackage() {
    Py_FinalizeEx();
  }

  void whatever() {
    // 封装调用Python模块的逻辑
  }

private:
  PyObject* module;
};

MyPackage package; // 全局实例

void my_func(void) {
  blah();
  package.whatever();
}

可行方案分析 #

1. 全局单例类（推荐思路二）

这是最适配场景的方案：

• 全局实例的构造函数会在程序启动阶段（main函数执行前）自动触发，完成Python解释器初始化和模块加载；
• 析构函数会在程序退出时（main函数执行后）自动调用，执行Py_FinalizeEx()完成清理；
• 注意事项：要确保全局实例的初始化顺序不会引发依赖问题（比如其他全局对象不能在该实例初始化前调用Python逻辑）；同时Py_Initialize()非线程安全，需保证启动阶段无多线程并发初始化该对象。

2. 首次调用初始化+atexit注册清理（优化思路一）

调整思路一的核心是用标准库的std::atexit()注册清理逻辑，无需自己判断程序退出时机：

#include <Python.h>
#include <cstdlib>
#include <mutex>

static PyObject* g_module = nullptr;
static std::mutex g_init_mutex;

static void cleanup_python() {
  if (g_module) {
    Py_DECREF(g_module);
    g_module = nullptr;
  }
  Py_FinalizeEx();
}

void my_func(void) {
  std::lock_guard<std::mutex> lock(g_init_mutex);
  if (!g_module) {
    Py_Initialize();
    g_module = load_python_module();
    std::atexit(cleanup_python);
  }
  // 业务代码：调用g_module中的函数
  // 多线程场景下需额外管理GIL：PyGILState_Ensure() / PyGILState_Release()
}

这种方式更轻量化，无需全局类，但必须加锁保证首次初始化的线程安全。

关键注意事项 #

• GIL管理：多线程调用Python逻辑时，必须用PyGILState_Ensure()获取全局解释器锁，执行完后调用PyGILState_Release()释放；
• Py_FinalizeEx限制：部分Python扩展不支持多次初始化/清理，因此必须保证全程只初始化一次、退出时清理一次；
• 资源释放：所有通过Python API获取的对象（如模块、函数、参数）都要使用Py_DECREF()正确释放引用，避免内存泄漏。

内容的提问来源于stack exchange，提问作者user171780