PyQt5布局无法添加pyqtgraph的GraphicsLayoutWidget问题求助

以下代码在多台机器上可正常运行（显示QLineEdit输入框在黑色方块上方）：

import pyqtgraph as pg
from PyQt5.QtWidgets import QWidget, QLineEdit, QVBoxLayout, QLabel, QApplication
import sys

class Test(QWidget):
    def __init__(self, headers: list = None, parent=None):
        QWidget.__init__(self, parent=parent)

        layout = QVBoxLayout(self)

        layout.addWidget(QLabel('QLineEdit'))
        w = QLineEdit()
        print(type(w))
        layout.addWidget(w)

        x = pg.GraphicsLayoutWidget()
        print(type(x))
        layout.addWidget(x)


if __name__ == "__main__":
    app = QApplication(sys.argv)
    main = Test()
    main.show()
    app.exec()

但某台机器运行时抛出错误：

File "my_file.py", line 22, in __init__
    layout.addWidget(self, w)
TypeError: addWidget(self, a0: QWidget, stretch: int = 0, alignment: Union[Qt.Alignment, Qt.AlignmentFlag] = Qt.Alignment()): argument 1 has unexpected type 'GraphicsLayoutWidget'

已做排查：

• 添加self.setLayout(layout)无效
• 统一两台机器的软件包版本（Python3.11.1、PyQt5.15.8、pyqtgraph0.13.1，其余包版本一致）
• 故障机器重装PyQt5和pyqtgraph后错误仍存在
• 打印类型显示：QLineEdit为<class 'PyQt5.QtWidgets.QLineEdit'>，GraphicsLayoutWidget为<class 'pyqtgraph.widgets.GraphicsLayoutWidget.GraphicsLayoutWidget'>
• PyCharm和命令行运行结果一致，PyQt5无法识别该组件为QWidget，且无法在正常机器复现错误

• 检查Qt绑定一致性：
  运行以下代码，确认GraphicsLayoutWidget是否正确继承自PyQt5的QWidget：

  import PyQt5.QtWidgets
  print("PyQt5 QWidget:", PyQt5.QtWidgets.QWidget)
  import pyqtgraph.widgets.GraphicsLayoutWidget
  print("GraphicsLayoutWidget bases:", pyqtgraph.widgets.GraphicsLayoutWidget.GraphicsLayoutWidget.__bases__)
  

  如果输出中没有PyQt5.QtWidgets.QWidget，说明pyqtgraph链接了错误的Qt绑定（比如PySide）。

• 强制指定pyqtgraph使用PyQt5：
  在代码最开头添加环境变量设置，强制pyqtgraph加载PyQt5绑定：

  import os
  os.environ['PYQTGRAPH_QT_LIB'] = 'PyQt5'
  import pyqtgraph as pg
  

  或者在运行脚本前设置系统环境变量：

  # Linux/macOS
  export PYQTGRAPH_QT_LIB=PyQt5
  # Windows
  set PYQTGRAPH_QT_LIB=PyQt5
  

• 创建全新虚拟环境：
  故障机器可能存在环境残留问题，创建干净的虚拟环境重新安装依赖：

  # 创建虚拟环境
  python -m venv pyqt_clean_env
  # 激活虚拟环境（Windows）
  pyqt_clean_env\Scripts\activate
  # 激活虚拟环境（Linux/macOS）
  source pyqt_clean_env/bin/activate
  # 安装指定版本依赖
  pip install PyQt5==15.8 pyqtgraph==0.13.1
  

• 确认Python解释器一致性：
  检查运行脚本的Python解释器和安装依赖的pip是否对应同一路径：

  # 查看Python路径
  which python  # Linux/macOS
  where python  # Windows
  # 查看pip对应解释器路径
  pip --version
  

  如果路径不一致，说明使用了错误的解释器运行脚本。

内容的提问来源于stack exchange，提问作者Harris Rutbeck-Goldman