如何在C++中获取PyQt创建对象的原生句柄（pybind11嵌入式环境）

要实现将PyQt创建的设置部件嵌入C++ Qt应用，核心是拿到PyQt对象对应的底层C++ Qt部件指针，以下是具体步骤：

1. 确保环境一致性 #

• 必须保证C++ Qt应用与PyQt使用的Qt主版本、编译模式（Release/ Debug）、编译器完全一致，否则会因ABI不兼容导致崩溃。
• 确认Python环境已安装对应版本的PyQt（PyQt5/PyQt6均可，需与C++ Qt版本匹配）。

2. 从Python插件暴露底层指针 #

PyQt通过sip模块提供了直接获取C++对象指针的API：sip.unwrapinstance()。在Python插件中，创建好设置部件后，返回该指针的整数形式（跨语言传递指针需转为整数避免类型问题）。

示例Python代码：

import sip
from PyQt5.QtWidgets import QWidget, QVBoxLayout, QLabel

class PythonSettingsWidget(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout(self)
        layout.addWidget(QLabel("这是Python插件的设置部件"))
    
    def get_cpp_pointer(self):
        # 返回底层C++ QWidget指针的整数形式
        return int(sip.unwrapinstance(self))

# 暴露给C++的入口函数
def create_settings_widget():
    widget = PythonSettingsWidget()
    return widget.get_cpp_pointer()

3. 在C++侧通过pybind11获取并转换指针 #

用pybind11加载Python插件并调用暴露的函数，拿到整数后转换为Qt部件指针：

示例C++代码：

#include <pybind11/pybind11.h>
#include <QWidget>
#include <QVBoxLayout>

namespace py = pybind11;

// 嵌入Python并获取设置部件指针
QWidget* getPythonSettingsWidget() {
    // 初始化Python解释器（如果未初始化）
    py::scoped_interpreter guard{};

    // 加载Python模块（假设插件文件名为settings_plugin.py）
    py::module_ plugin = py::module_::import("settings_plugin");
    // 调用Python函数获取指针整数
    py::int_ ptr_int = plugin.attr("create_settings_widget")().cast<py::int_>();
    
    // 转换为uintptr_t再转为QWidget指针
    uintptr_t ptr_val = static_cast<uintptr_t>(ptr_int);
    QWidget* python_widget = static_cast<QWidget*>(reinterpret_cast<void*>(ptr_val));
    
    return python_widget;
}

// 将部件嵌入C++设置界面
void embedPythonSettings(QWidget* parent_settings_widget) {
    QWidget* python_widget = getPythonSettingsWidget();
    if (!python_widget) return;

    // 设置父部件，让C++ Qt管理其生命周期
    python_widget->setParent(parent_settings_widget);
    // 添加到父部件的布局中
    parent_settings_widget->layout()->addWidget(python_widget);
}

4. 关键注意事项 #

• 生命周期管理：设置python_widget->setParent(parent_settings_widget)后，Qt的父部件会负责销毁子部件，避免Python侧和C++侧双重释放或悬空指针。
• 避免悬空指针：如果Python侧手动销毁了部件（比如调用del widget），C侧的指针会失效，因此需确保C持有部件期间，Python侧不主动释放对象。
• PyQt6兼容性：上述代码中sip.unwrapinstance()在PyQt6中同样可用，无需修改Python代码，只需将C++中的PyQt5相关头文件改为PyQt6即可。

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