PyQt4安装完整教程 - Python GUI开发入门指南

来源：

http://yc-hardware.com
http://www.yc-hardware.com
http://dgjcpcb.com
http://www.dgjcpcb.com

PyQt4简介

PyQt4是一个创建GUI应用程序的跨平台工具包，它将Qt库与Python语言完美结合。使用PyQt4，开发者可以快速构建功能丰富、界面美观的桌面应用程序。

为什么选择PyQt4？

• 跨平台支持：Windows、Linux、macOS
• 丰富的UI组件和功能
• 强大的信号与槽机制
• 成熟的社区支持
• 同时支持Python 2和Python 3

安装前准备

步骤1：安装Python

PyQt4需要Python环境，请确保已安装Python：

• 推荐使用Python 3.6+
• 访问 Python官网 下载安装包
• 安装时勾选"Add Python to PATH"

步骤2：验证Python安装

打开终端或命令提示符，执行以下命令：

python --version
# 或
python3 --version

应显示Python版本号，如：Python 3.9.7

步骤3：确保pip可用

pip是Python包管理工具，检查是否安装：

pip --version
# 或
pip3 --version

如果未安装，请参考官方文档安装pip

PyQt4安装步骤

根据不同操作系统选择安装方法：

Windows

macOS

Linux

Windows系统安装方法

方法1：使用预编译的二进制包

访问 Christoph Gohlke的PyQt4页面 下载对应版本的whl文件：

• 根据Python版本选择：PyQt4-4.11.4-cpXX-cpXX-win_amd64.whl
• cpXX表示Python版本（如cp37表示Python 3.7）

下载完成后，在whl文件所在目录执行：

pip install PyQt4-4.11.4-cp37-cp37m-win_amd64.whl

方法2：使用Anaconda

如果你使用Anaconda，可以通过conda安装：

conda install pyqt=4

macOS系统安装方法

方法1：使用Homebrew

安装Homebrew（如果尚未安装）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装PyQt4：

brew install cartr/qt4/pyqt@4

方法2：使用pip安装

确保已安装必要的依赖：

brew install qt@4

然后使用pip安装：

pip install PyQt4

Linux系统安装方法

Ubuntu/Debian

sudo apt-get update
sudo apt-get install python3-pyqt4

Fedora/CentOS/RHEL

sudo yum install PyQt4

或

sudo dnf install python3-qt4

Arch Linux

sudo pacman -S python-pyqt4

验证安装

创建测试文件 pyqt4_test.py：

import sys
from PyQt4 import QtGui

app = QtGui.QApplication(sys.argv)

window = QtGui.QWidget()
window.setWindowTitle('PyQt4安装成功')
window.setGeometry(100, 100, 300, 200)

label = QtGui.QLabel('恭喜！PyQt4已成功安装', window)
label.setGeometry(50, 80, 200, 30)
label.setAlignment(QtCore.Qt.AlignCenter)

window.show()
sys.exit(app.exec_())

运行脚本：

python pyqt4_test.py

如果看到显示"恭喜！PyQt4已成功安装"的窗口，说明安装成功！

PyQt4安装成功

恭喜！PyQt4已成功安装

常见问题解决

Q: 安装时出现"ModuleNotFoundError: No module named 'PyQt4'"错误？

A: 这表示PyQt4未正确安装。请确保：

• 使用了正确的Python环境
• 安装命令没有报错
• 尝试重新安装

Q: 在Windows上安装时出现版本不匹配错误？

A: 请确保下载的whl文件与你的Python版本和系统架构（32位/64位）匹配。

Q: macOS安装时遇到权限问题？

A: 尝试使用sudo运行pip命令：

sudo pip install PyQt4

Q: Linux安装时缺少依赖？

A: 确保安装了所有开发工具：

sudo apt-get build-dep python-qt4  # Ubuntu/Debian
sudo dnf builddep python-qt4     # Fedora

注意： PyQt4官方支持已结束，建议新项目使用PyQt5或PySide2。PyQt4适用于维护旧项目或特定环境要求。