Python 3.10.12+PyQt6环境下pyqtgraph示例无法运行求助

核心原因排查 #

'pyqtgraph' is not a package这个报错优先考虑安装或路径冲突问题，而非PyQt6兼容性——pyqtgraph 0.13.x完全支持PyQt6，官方示例也适配了该版本。常见触发场景：

• 项目目录里存在同名的pyqtgraph.py文件、pyqtgraph文件夹，覆盖了第三方库的包路径
• pyqtgraph安装不完整，或者安装到了非当前Python环境的路径中

快速修复步骤 #

• 排查同名文件/文件夹
  直接检查项目根目录，若有pyqtgraph.py、pyqtgraph.ipynb或pyqtgraph文件夹，立刻删掉或重命名，避免干扰包导入。

• 确认并修复pyqtgraph安装
  打开终端执行以下命令：

  # 检查当前环境的pyqtgraph版本
  python -c "import pyqtgraph; print(pyqtgraph.__version__)"
  # 强制重装，确保安装完整
  pip install --force-reinstall pyqtgraph==0.13.3
  

  如果第一条命令同样报错，说明安装路径有误，先卸载再重装：

  pip uninstall -y pyqtgraph
  pip install pyqtgraph==0.13.3
  

• 验证PyQt6适配性
  安装完成后，测试基础导入：

  from pyqtgraph.Qt import QtCore, QtGui, QtWidgets
  print(QtCore.Q_VERSION_STR)  # 正常会输出6.5.2左右的版本
  

  能运行就说明兼容性没问题。

原有PyQt5代码的最小修改 #

如果原有代码基于PyQt5开发，pyqtgraph的Qt模块做了兼容层，大部分代码不用改。少数需要注意的差异：

• PyQt6中部分枚举值层级调整（比如Qt.AlignCenter改为Qt.AlignmentFlag.AlignCenter），pyqtgraph会自动处理大部分场景，个别报错的地方直接替换即可
• 移除PyQt5特有的导入语句，统一用from pyqtgraph.Qt import ...

总结 #

这个问题90%以上是安装或路径冲突导致的，和PyQt6兼容性无关。按上述步骤修复后，官方示例和原有项目都能正常运行，不需要大量修改代码。

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