在统信uos的aarch64平台安装pyqt5需执行pip3 install pyqt5 --config-settings confirm-license=yes,并安装libqt5core5a、libxcb-cursor0等依赖库,最后通过运行含qapplication的测试脚本验证窗口正常弹出。

在统信UOS系统上安装PyQt5是开发桌面应用的刚需,尤其当你需要构建符合国产化适配要求的GUI程序时——但直接运行pip install pyqt5会卡在许可证确认环节,且arm64/aarch64平台下默认源下载极慢甚至超时失败。
确认Python和pip环境
先验证基础环境是否就绪:打开终端,执行python3 --version确认已安装Python 3.7+;再运行python3 -m pip --version。若提示“未找到命令”,说明pip未安装或未正确注册到PATH中。
用系统包管理器安装pip(推荐):sudo apt-get update && sudo apt-get install python3-pip。
【注意】不要单独安装python-pip,它对应Python 2,而PyQt5仅支持Python 3。
解决aarch64平台安装卡住问题
aarch64架构(如鲲鹏、飞腾芯片)下pip install pyqt5会卡在交互式许可证确认界面,键盘输入无效。
方法一:强制跳过许可证确认
执行命令:pip3 install pyqt5 --config-settings editable-verbose=true --config-settings confirm-license=yes。
方法二:换用国内镜像源加速下载
先配置清华源:pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/,再运行安装命令。
这一步操作起来很简单,直接把命令复制粘贴执行就行,但必须等完整下载完成(通常需30~60分钟),中途中断会导致wheel包损坏,重装前需手动清理~/.cache/pip。
处理依赖缺失报错
安装过程中若出现Could not find QtCore或ImportError: libxcb-cursor.so.0等错误,说明系统缺少Qt5运行时库或X11扩展组件。
第一步:安装Qt5核心运行库sudo apt-get install libqt5core5a libqt5gui5 libqt5widgets5 libqt5dbus5。
第二步:补全xcb插件依赖(统信UOS桌面环境关键)sudo apt-get install libxcb-xinerama0 libxcb-xinput0 libxcb-xkb1 libxcb-xrm0 libxcb-cursor0。
第三步:验证是否生效
运行python3 -c "from PyQt5.QtWidgets import QApplication; print('OK')",无报错即成功。
【重要前提】必须先完成第二步的xcb系列库安装,否则即使PyQt5安装成功,运行时也会崩溃。
验证安装并测试最小窗口
新建文件test.py,写入以下内容:
import sys<br>from PyQt5.QtWidgets import QApplication, QLabel<br>app = QApplication(sys.argv)<br>label = QLabel("PyQt5 in UOS OK")<br>label.show()<br>sys.exit(app.exec_())
在终端中执行:python3 test.py。
如果弹出一个带文字的小窗口,且终端无报错,说明PyQt5已在统信UOS上完全可用。











