如何将PyVista绘图嵌入Qt Designer生成的PyQt标签页并解决相关报错

• 核心冲突是PyQt6版本和VTK、pyvistaqt的兼容问题：你当前版本的VTK中QVTKRenderWindowInteractor初始化时，不接受原生PyQt6的QWidget作为父组件参数，类型校验不匹配
• 另一个错误实践是直接修改Qt Designer导出的UI代码：手动在自动生成的Ui_MainWindow中添加QtInteractor逻辑，下次重新导出UI时会覆盖所有修改，且硬编码坐标的方式适配性极差

步骤1：调整Qt Designer设计（不要手动修改导出的UI代码） #

1. 打开你的UI设计文件，在Tab1中删除之前手动加的QtInteractor，拖入一个普通QWidget作为PyVista绘图区的占位容器，将其objectName设为pv_container
2. 选中Tab1，点击工具栏的「垂直布局」按钮，让占位容器自动填充整个Tab1区域
3. 重新导出UI为ui_main.py，不要修改这个文件的任何内容

步骤2：编写独立的主程序逻辑（和自动生成的UI代码解耦） #

主程序代码如下：

import sys
# 统一用qtpy导入组件，自动适配Qt版本，避免类型不兼容
from qtpy import QtWidgets, QtCore
import numpy as np
import pyvista as pv
from pyvistaqt import QtInteractor
# 导入你从Qt Designer导出的UI类
from ui_main import Ui_MainWindow

class MainWindow(QtWidgets.QMainWindow, Ui_MainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 先加载UI布局
        self.setupUi(self)
        
        # 初始化PyVista交互器，父组件设为占位容器
        self.plotter = QtInteractor(parent=self.pv_container)
        # 把交互器添加到占位容器的布局中
        self.pv_container.layout().addWidget(self.plotter)

        # 这里复制你原来的PyVista绘图逻辑
        x = np.array([1,2,3,4,5,6,7,8,9])
        y = np.array([1,2,3,4,5,6,7,8,9])
        x, y = np.meshgrid(x, y)
        z = x*y

        self.grid = pv.StructuredGrid(x, y, z)
        self.plotter.show_grid()
        self.plotter.add_mesh(
            self.grid, 
            scalars=self.grid.points[:, -1], 
            lighting=True, 
            specular=0.5, 
            smooth_shading=True, 
            show_edges=True,
            scalar_bar_args={'vertical': True}
        )
        self.plotter.set_scale(
            xscale=1, 
            yscale=x.ptp()/y.ptp(), 
            zscale=x.ptp()/z.ptp()
        )

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

如果上述方案仍有PyQt6版本兼容问题，可以安装适配更好的依赖：

pip install qtpy pyqt6 vtk==9.2.6 pyvista pyvistaqt

VTK 9.2.6及以上版本对PyQt6的支持已经完善，升级后即可解决类型报错问题。

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