从PyQt5导入QtWidgets遇ImportError：架构不匹配无合适镜像

问题重现 #

运行Python代码时导入PyQt5的QtWidgets模块触发ImportError，错误回溯如下：

Traceback (most recent call last):
  File "/Users/Chayma/pythonProject/venv/main.py", line 3, in <module>
    from PyQt5 import QtWidgets
ImportError: dlopen(/Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/PyQt5/QtWidgets.abi3.so, 2): no suitable image found.   Did find:
    /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/PyQt5/QtWidgets.abi3.so: mach-o, but wrong architecture
    /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/PyQt5/QtWidgets.abi3.so: mach-o, but wrong architecture

使用的代码如下：

import sys
from PyQt5.uic import loadUi
from PyQt5 import QtWidgets
import PyQt5.QtWidgets as QtWidgets
from PyQt5.QtWidgets import QDialog, QApplication, QWidget

class MainWindow(QDialog):
    def __init__(self):
        super(MainWindow, self).__init__()
        loadUi("helloooo.ui", self)


#main
app = QApplication(sys.argv)
mainwindow = MainWindow()
widget = QtWidgets.QStackedWidget()
widget.addWidget(mainwindow)
widget.setFixedHeight(800)
widget.setFixedWidth(1200)
widget.show()
     

try:
    sys.exit(app.exec_())
except:
    print("exit")

错误核心原因：PyQt5的二进制文件架构与当前Python运行环境的CPU架构不匹配（比如M系列Mac安装了x86_64版本的PyQt5包）。

解决步骤 #

• 卸载现有不兼容的PyQt5包
  终端执行命令：

  pip uninstall PyQt5 PyQt5-sip -y
  

• 确认当前Python环境的架构
  终端执行命令：

  python3 -c "import platform; print(platform.machine())"
  

  输出arm64对应M系列Mac架构，x86_64对应Intel架构。
• 重新安装对应架构的PyQt5
  • 若为arm64架构，直接执行：

    pip install PyQt5
    

  • 若为x86_64架构（或通过Rosetta运行的Python环境），执行：

    arch -x86_64 pip install PyQt5
    

• 验证安装结果
  运行以下代码测试导入是否成功：

  from PyQt5 import QtWidgets
  print("QtWidgets导入成功")
  

代码优化建议 #

原代码存在重复导入QtWidgets的冗余问题，可简化为：

import sys
from PyQt5.uic import loadUi
from PyQt5.QtWidgets import QDialog, QApplication, QWidget, QStackedWidget

class MainWindow(QDialog):
    def __init__(self):
        super().__init__()
        loadUi("helloooo.ui", self)


#main
app = QApplication(sys.argv)
mainwindow = MainWindow()
widget = QStackedWidget()
widget.addWidget(mainwindow)
widget.setFixedHeight(800)
widget.setFixedWidth(1200)
widget.show()
     

try:
    sys.exit(app.exec_())
except:
    print("exit")

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