PyQt5导入报ModuleNotFoundError 已重装仍无法解决求修复方案

• 检查Python环境一致性
  运行代码的Python解释器和安装PyQt5的pip可能不属于同一个环境。先在终端输入python --version（或python3 --version）确认当前用的Python版本，再输入pip --version（或pip3 --version）看pip对应的Python版本是否匹配。如果不匹配，用对应版本的pip安装，比如python3 -m pip install pyqt5。

• 强制清理缓存后重装
  卸载时彻底清理缓存，再重新安装：

  pip uninstall -y pyqt5
  pip install pyqt5 --no-cache-dir
  

  如果用了虚拟环境，记得先激活环境再执行命令。

• 验证PyQt5安装路径是否在Python搜索路径里
  执行pip show pyqt5查看安装位置，然后在Python交互窗口里运行以下代码，确认安装路径在输出的列表中：

  import sys
  print(sys.path)
  

  如果不在，可临时手动添加路径（不推荐长期使用）：

  import sys
  sys.path.append("PyQt5的实际安装路径")
  from PyQt5.QtWidgets import *
  

• 检查IDE的解释器配置
  如果你用VS Code、PyCharm这类IDE，确认IDE选择的Python解释器是安装了PyQt5的那个。比如PyCharm可在File > Settings > Project > Python Interpreter里查看切换；VS Code按Ctrl+Shift+P选择Python: Select Interpreter切换到对应环境。

• 尝试安装wheel包
  源码安装可能出问题，试试直接安装wheel包：

  1. 先安装wheel工具：pip install wheel
  2. 从PyPI下载对应系统和Python版本的PyQt5 wheel文件（比如pyqt5-5.15.9-cp311-none-win_amd64.whl）
  3. 用pip install 下载的文件名.whl完成安装

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