在uos上搭建pyqt5开发环境需先执行sudo apt update && sudo apt install qttools5-dev-tools python3-pyqt5 python3-pyqt5-dev,安装后通过designer命令验证;pycharm中配置external tools:qt designer路径为/usr/bin/designer,working directory设为$projectfiledir$;pyuic可选pyuic5或python3 -m pyqt5.uic.pyuic,working directory须为$filedir$;若报“modulenotfounderror: no module named 'pyqt5.uic'”,需补装python3-pyqt5-dev;登录界面制作流程含创建login.ui、designer中拖控件、设objectname、应用栅格布局、pyuic生成login.py。

在UOS(统一操作系统)上搭建PyQt5开发环境并用Qt Designer可视化设计GUI界面,需先确认系统底层为Debian/Ubuntu系——UOS个人版基于Debian 11,因此apt源和包名与Ubuntu 20.04/22.04高度兼容,直接沿用对应apt命令即可完成安装与集成。
安装Qt Designer和PyQt5依赖
打开终端,依次执行以下命令:
sudo apt update
sudo apt install qttools5-dev-tools python3-pyqt5 python3-pyqt5-dev
这一步必须一次性装全:qttools5-dev-tools提供designer可执行文件,python3-pyqt5是运行时库,python3-pyqt5-dev包含头文件和uic/pyrcc等工具。漏装pyqt5-dev会导致后续pyuic调用失败。
安装完成后,在终端输入 【designer】 回车,若弹出Qt Designer主窗口即表示安装成功。
在PyCharm中配置Qt Designer为外部工具
启动PyCharm → File → Settings → Tools → External Tools → 点击左上角“+”号添加新工具。
填写以下三项关键内容:
Name:Qt Designer(可自定义)
Program:【/usr/bin/designer】(UOS中该路径为标准位置,勿填/usr/lib/x86_64-linux-gnu/qt5/bin/designer,后者在UOS中不存在)
Working directory:【$ProjectFileDir$】(确保新建.ui文件默认保存在项目根目录下)
Arguments留空即可——UOS版designer不强制要求传入文件参数,双击打开后可手动新建或打开.ui文件。
配置PyUIC将.ui转为.py代码
仍在External Tools界面,再次点击“+”号添加第二个工具:
方法一:使用系统自带pyuic5
Name:PyUIC
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
Program:【/usr/bin/pyuic5】
Arguments:【$FileName$ -o $FileNameWithoutExtension$.py】
Working directory:【$FileDir$】(注意不是$ProjectFileDir$,必须定位到.ui文件所在目录)
方法二:用Python模块方式调用(兼容性更强)
Program:【/usr/bin/python3】
Arguments:【-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py】
Working directory同上设为【$FileDir$】
⚠️ 注意:如果执行PyUIC时报错“ModuleNotFoundError: No module named 'PyQt5.uic'”,说明python3-pyqt5-dev未安装,需返回第一步补装。
实际制作一个登录界面
步骤一:在PyCharm项目根目录右键 → New → File → 输入login.ui → 回车
步骤二:右键刚创建的login.ui → External Tools → Qt Designer
步骤三:在Designer中拖入Widget → 在Object Inspector中将其objectName改为LoginDialog
步骤四:从Widget Box拖入QLabel、QLineEdit(两次)、QPushButton(两次),分别设置text为“用户名”“密码”“登录”“取消”,并修改对应objectName为userEdit、pwdEdit、btnLogin、btnCancel
步骤五:选中LoginDialog → Ctrl+R → 应用栅格布局(Grid Layout),让控件自动对齐
步骤六:保存.ui文件 → 右键login.ui → External Tools → PyUIC
步骤七:检查项目目录下是否生成login.py,打开后确认class Ui_LoginDialog已生成,且setupUi方法内含全部控件初始化代码










