安装 PyQt 主要有两种主流方式：使用 pip 安装（推荐） 和 从源码编译安装（适合定制化需求）。以下是详细步骤，涵盖不同操作系统（Windows/macOS/Linux）和常见问题解决。
一、前置准备：确认 Python 和 pip 环境
-
检查 Python 是否安装：
打开终端/命令提示符，输入：python --version # Windows 可能是 python3 --version pip --version # 确认 pip 可用（Python 3.4+ 自带 pip）如果未安装 Python，先从 Python 官网 下载（建议 3.7+ 版本，兼容 PyQt5/6）。
-
升级 pip（避免安装失败）：
pip install --upgrade pip # Windows pip3 install --upgrade pip # macOS/Linux
二、核心安装：PyQt5 或 PyQt6（二选一）
PyQt 分为 PyQt5（稳定、生态成熟）和 PyQt6（最新版，适配 Qt6），推荐优先选 PyQt5（教程/第三方库兼容性更好）。
方式 1：pip 安装（最简单，推荐）
1. 安装 PyQt5（主流选择）
# Windows
pip install pyqt5# macOS/Linux
pip3 install pyqt5
补充：安装 PyQt5 工具（含 Qt Designer 可视化设计器）
Qt Designer 是快速制作界面的核心工具，需单独安装：
# Windows
pip install pyqt5-tools# macOS/Linux
pip3 install pyqt5-tools
2. 安装 PyQt6（最新版）
# Windows
pip install pyqt6# macOS/Linux
pip3 install pyqt6# 安装 PyQt6 工具（Qt Designer）
pip install pyqt6-tools # Windows
pip3 install pyqt6-tools # macOS/Linux
方式 2：从源码编译安装（适合定制化）
如果需要修改 Qt 源码或适配特殊环境，可手动编译（步骤较复杂）：
- 下载 Qt 源码：从 Qt 官网 下载对应版本的 Qt 源码。
- 下载 PyQt 源码：从 Riverbank Computing 下载 PyQt5/6 源码。
- 编译安装（以 PyQt5 为例）：
# 解压源码后进入目录 python configure.py --qmake /path/to/qt/bin/qmake make # macOS/Linux make install # Windows 需用 MSVC 或 MinGW 编译，建议参考官方文档
三、验证安装是否成功
安装完成后，运行以下代码测试：
# 测试 PyQt5
import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabelapp = QApplication(sys.argv)
window = QWidget()
window.setWindowTitle('PyQt5 安装成功！')
label = QLabel(window)
label.setText('Hello PyQt5!')
label.move(50, 50)
window.resize(300, 200)
window.show()
sys.exit(app.exec_())
如果弹出包含「Hello PyQt5!」的窗口，说明安装成功。
四、常见问题解决
-
pip 安装超时/失败
改用国内镜像源（如清华源）：pip install pyqt5 -i https://pypi.tuna.tsinghua.edu.cn/simple -
Qt Designer 找不到（Windows）
pyqt5-tools 安装后，Designer 路径通常在：
Python安装目录\Lib\site-packages\qt5_applications\Qt\bin\designer.exe
可将该路径添加到系统环境变量，方便直接启动。 -
macOS 提示“无法打开应用”
右键 Qt Designer 图标 → 打开 → 确认信任，即可正常使用。 -
Linux 缺少依赖
以 Ubuntu 为例，安装缺失的库：sudo apt-get install libxkbcommon-x11-0 libxcb-xinerama0
总结
- 新手优先用
pip install pyqt5 pyqt5-tools，简单快捷。 - 如需最新特性，选择 PyQt6。
- 验证安装的核心是导入 PyQt 模块并运行简单窗口代码。