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
下载
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 的落点。
