已安装PyQt6但PyQt6.QtWidgets模块找不到问题求助

架构老林

2026-8-9

解决PyQt6.QtWidgets模块找不到的问题

针对你遇到的问题，分享几个实用的排查和解决步骤：

彻底重装PyQt6
安装过程可能出现文件缺失，先卸载现有版本：
```
python3 -m pip uninstall -y PyQt6
```
然后强制重新安装完整包：
```
python3 -m pip install --force-reinstall PyQt6
```
安装完成后，可通过pip show PyQt6查看安装路径，到对应路径下的site-packages/PyQt6目录里确认是否存在QtWidgets文件夹。
确认Python环境一致性
macOS下容易出现多Python版本共存导致的环境混乱，检查python3和pip3是否指向同一个环境：
```
which python3
which pip3
```
如果路径不一致，说明pip安装的PyQt6不在当前运行的Python环境中，可直接用对应路径的Python运行脚本，比如：
```
/usr/local/bin/python3 your_script.py
```
（替换成你实际的Python路径）
补充安装PyQt6-sip依赖
PyQt6依赖sip库，偶尔会出现自动安装遗漏的情况，手动安装试试：
```
python3 -m pip install PyQt6-sip
```
尝试降级PyQt6版本
部分新版本PyQt6和macOS 12.5.1可能存在兼容性问题，试试安装稳定旧版本，比如6.4.0：
```
python3 -m pip install PyQt6==6.4.0
```