pyqt5在pycharm中正常调用qt designer和pyuic的核心是路径正确与环境匹配:必须使用conda虚拟环境而非pycharm默认venv,program指向conda环境中pyqt5_tools/qt/bin/designer.exe,pyuic需用python -m pyqt5.uic.pyuic并带-x参数,working directory设为$filedir$,且须配置qt_plugin_path环境变量确保插件加载。

PyQt5 能在 PyCharm 里正常调用 QtDesigner 和执行 pyuic 转换,核心不是“装了没”,而是“路径对不对”和“环境切没切”。只要虚拟环境激活正确、工具路径指向真实可执行文件、参数不漏关键字段,基本不会报错。
确认你用的是 conda 虚拟环境,不是 PyCharm 自带的 venv
PyCharm 默认创建的 venv 环境无法直接使用 Anaconda 安装的 PyQt5-tools,因为 designer.exe 和 pyuic 实际在 conda 环境的 site-packages/pyqt5_tools 或 Library/bin/ 下。必须手动指定 conda 环境路径:
- 打开 PyCharm → File → Settings → Project → Python Interpreter
- 点击右上角齿轮 → Add → Conda Environment → Existing environment
- Interpreter 路径填:
D:\DevTools\Anaconda3\envs\pyqt5_env\python.exe(替换成你自己的 conda 环境路径) - 确认后,PyCharm 就会识别该环境中已安装的
PyQt5和PyQt5-tools
配置 QtDesigner:别用 Library/bin/designer.exe 直接路径
很多教程抄来抄去,让你填 Library/bin/designer.exe,但这个路径在较新版本的 Anaconda(尤其是 2023+)中经常不存在——它被移到了 envs/xxx/Lib/site-packages/pyqt5_tools/ 下。实际可执行文件是 designer.bat 或 designer.exe,但必须从 pyqt5_tools 子目录找:
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 先在终端激活你的 conda 环境:
conda activate pyqt5_env - 运行:
python -c "import pyqt5_tools; print(pyqt5_tools.__file__)",得到包路径 - 往上退两级,进入
pyqt5_tools\Qt\bin\,里面才有designer.exe - PyCharm 中 External Tools 的
Program填这个真实路径,例如:D:\DevTools\Anaconda3\envs\pyqt5_env\Lib\site-packages\pyqt5_tools\Qt\bin\designer.exe -
Working directory设为$ProjectFileDir$,否则新建 UI 文件可能保存失败
配置 pyuic:用 python -m PyQt5.uic.pyuic,别硬找 pyuic5.exe
Windows 上 pyuic5.exe 经常缺失或权限受限;最稳的方式是走 Python 模块入口。PyCharm 的 External Tools 参数必须严格匹配,否则生成的 .py 文件缺 if __name__ == "__main__": 或报 AttributeError: 'module' object has no attribute 'pyuic':
-
Name: pyuic -
Program:D:\DevTools\Anaconda3\envs\pyqt5_env\python.exe(必须是你当前 conda 环境的 python.exe) -
Arguments:-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py -x -
Working directory:$FileDir$(注意是$FileDir$,不是$ProjectFileDir$,否则找不到当前 .ui 文件) -
-x参数不能省——它让生成的代码自动包含if __name__ == "__main__":,方便直接运行调试
容易被忽略的两件事:QT_PLUGIN_PATH 和 designer 启动卡死
即使上面都配对了,designer.exe 可能启动后空白、无控件、点不了按钮——这是 Qt 插件加载失败。根本原因是 Windows 找不到 platforms 和 styles 插件目录:
- 查插件路径:在 conda 环境中运行
python -c "from PyQt5 import QtCore; print(QtCore.QLibraryInfo.location(QtCore.QLibraryInfo.PluginsPath))" - 结果类似:
D:\DevTools\Anaconda3\envs\pyqt5_env\Lib\site-packages\pyqt5_tools\Qt\plugins - 把这个路径复制,新建系统环境变量:
QT_PLUGIN_PATH,值设为该路径 - 重启 PyCharm(不是重载项目,是彻底关掉再开),否则变量不生效
- 如果 designer 还卡死,检查是否开了杀毒软件拦截了
designer.exe,临时禁用试试










