Qt Designer 需手动配置为PyCharm外部工具:先安装pyqt5-tools,再通过QLibraryInfo定位designer.exe绝对路径填入Program栏,Working directory设为$FileDir$,Arguments留空;PyUIC推荐用-m PyQt5.uic.pyuic方式调用。

Qt Designer 不是 PyCharm 自带的,必须手动配置外部工具才能从 IDE 里一键调起。配置本身不难,但路径填错、依赖没装全、或工作目录设错,都会导致点击后无响应、报错 FileNotFoundError 或弹窗闪退。
确认 pyqt5-tools 已安装且 designer.exe 存在
PyQt5 本身不含 designer.exe,必须额外安装 pyqt5-tools(注意不是 pyqt-tools 或 pyqt6-tools):
- 在 PyCharm Terminal 中运行:
pip install pyqt5-tools - 安装完成后,用 Python 查找实际路径:
python -c "from PyQt5.QtCore import QLibraryInfo; print(QLibraryInfo.location(QLibraryInfo.BinariesPath))" - 典型输出类似:
C:\Users\XXX\AppData\Local\Programs\Python\Python310\Lib\site-packages\qt5_applications\Qt\bin - 进入该目录,确认存在
designer.exe;若不存在,尝试全局搜索designer.exe(推荐用 Everything),常见位置还包括:pyqt5_tools\Qt\bin\designer.exe或anaconda\Library\bin\designer.exe
PyCharm 中添加 QtDesigner 外部工具
路径错误是配置失败最常见原因,Program 必须指向 designer.exe 的绝对路径,不能用变量或相对路径:
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
-
Name:填QtDesigner(方便右键菜单识别) -
Program:粘贴你刚确认的完整路径,例如:C:\Users\Alice\AppData\Local\Programs\Python\Python310\Lib\site-packages\qt5_applications\Qt\bin\designer.exe -
Working directory:填$FileDir$(这样打开时默认保存到当前 .ui 文件所在目录) -
Arguments:留空(designer.exe不需要命令行参数启动)
PyUIC 转换 .ui 到 .py 的关键参数设置
直接调用 pyuic5.exe 容易因 Python 环境隔离失败,推荐用 -m PyQt5.uic.pyuic 方式绕过环境问题:
-
Name:填PyUIC -
Program:填你项目所用的 Python 解释器路径,例如:C:\Users\Alice\AppData\Local\Programs\Python\Python310\python.exe -
Arguments:-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py -
Working directory:$FileDir$(保证输入输出都在同一目录) - 注意:
$FileName$是带扩展名的文件名(如main.ui),$FileNameWithoutExtension$是去掉.ui后的部分(即main)
常见失败现象和对应检查点
点开 QtDesigner 没反应?右键 PyUIC 报错?先盯住这几个地方:
- PyCharm 是否用了虚拟环境?确保
pip install pyqt5-tools是在当前项目解释器环境下执行的 -
designer.exe路径中含中文或空格?Windows 下部分版本会卡住,建议重装到纯英文路径(如C:\pyqt\) - PyCharm 设置里是否勾选了「Synchronize files on frame activation」?关闭它可避免因文件被 designer 锁住导致 PyCharm 卡死
- 生成的
.py文件开头是否有from PyQt5 import QtCore, QtGui, QtWidgets?没有说明PyUIC执行失败,回看Arguments和Program是否匹配
designer.exe 在 Conda 环境、venv、系统 Python 下的位置完全不同,而且 PyCharm 不会自动帮你校验路径有效性。每次换环境或重装 Python,都得重新查一次 designer.exe 的落点。

















