43、PyQt安装指南

sql99

于 2025-12-13 16:59:11 发布

阅读量12

点赞数

CC 4.0 BY-SA版权

分类专栏： PyQt编程艺术文章标签： PyQt Python Qt

本文链接：https://blog.youkuaiyun.com/sql99/article/details/155958823

PyQt编程艺术专栏收录该内容

46 篇文章 ¥499.90

订阅专栏¥69.90

会员秒杀 ¥9.9 重磅福利

超级会员免费看

PyQt安装指南

1. 概述

所有用于开发的工具都可以在网上免费下载。不过，部分软件包体积较大，例如Qt约50MB，Python约12MB，PyQt约6MB，SIP约0.5MB，因此建议使用宽带连接进行下载。

在不同操作系统（Windows、Mac OS X、大多数基于X11的Unix及类Unix系统，如Linux和BSD）上，安装过程包含下载和安装两个步骤。各软件包都有自己的安装说明，通常比这里提供的更及时和全面，但本文内容也足以帮助完成工具的安装和使用。

2. Windows系统安装步骤

在Windows系统上，需要安装四个工具：C++编译器、Qt C++应用开发框架、Python解释器及其相关库，以及PyQt4（Windows二进制包中包含SIP）。这里假设使用GPL版本，与Qt兼容的C++编译器只有MinGW（Visual C++仅适用于Qt和PyQt的商业版本）。

2.1 下载

下载顺序 ：
1. PyQt ：访问http://www.riverbankcomputing.co.uk/pyqt/download.php ，下载二进制包，如PyQt - gpl - 4.2 - Py2.5 - Qt4.2.3.exe 。文件名中的版本号很重要，PyQt版本至少为4.2，第二个数字是所需Python版本，第三个数字是Qt版本，必须下载精确匹配的版本。
2. Qt ：访问http://www.trolltech.com/developer/downloads/qt/index ，点击Qt/Windows Open Source Edition链接，在页面底部下载qt - win - opensource - 4.2.3 - mingw.exe ，版本号要与PyQt包中的一致。
3. MinGW C++编译器 ：访问ftp://ftp.trolltech.com/misc/ ，下载MingGW - 3.4.2.exe 。也可以让Qt安装程序自动下载，但手动下载便于在其他机器上安装或系统出现问题时恢复。
4. Python ：访问http://www.python.org/download ，下载Windows安装程序。选择适合硬件的安装程序，如AMD64或Itanium版本；若不匹配则选择第一个，如“Python 2.5.1 Windows installer” ，保存为.msi文件。Python版本号的前两位要与PyQt版本号对应部分一致。
5. 示例文件 ：若想运行示例或查看练习答案，可从http://www.qtrac.eu/pyqtbook.html 下载并解压pyqtbook.zip文件。

软件名称	下载链接	版本要求
PyQt	http://www.riverbankcomputing.co.uk/pyqt/download.php	至少4.2，版本号与Python、Qt匹配
Qt	http://www.trolltech.com/developer/downloads/qt/index	与PyQt版本号一致
MinGW	ftp://ftp.trolltech.com/misc/	3.4.2
Python	http://www.python.org/download	前两位版本号与PyQt匹配
示例文件	http://www.qtrac.eu/pyqtbook.html	-

2.2 安装

安装顺序与下载顺序不同，必须先安装C++编译器，最后安装PyQt。

graph LR
    A[开始] --> B[安装MinGW]
    B --> C[安装Qt]
    C --> D[设置环境变量]
    D --> E[安装Python]
    E --> F[安装PyQt]
    F --> G[测试安装]
    G --> H[结束]

MinGW安装 ：若未下载MinGW安装程序（已有编译器或让Qt安装程序自动获取），则跳过此步骤。否则，双击MinGW - 3.4.2.exe ，按安装程序提示操作，只需选择安装位置，默认是C:\MinGW ，非标准位置需记录路径供Qt安装时使用。
Qt安装 ：双击qt - win - opensource - 4.2.3 - mingw.exe ，按提示操作，默认安装目录为C:\Qt\4.2.3 。在“MinGW Installation”屏幕，若MinGW安装在标准位置，路径应正确；否则需手动输入或浏览查找。若未安装MinGW，勾选“Download and install minimal MinGW” 。
环境变量设置 ：由于GPL Qt安装程序不会将Qt添加到系统路径，需手动添加。操作步骤如下：
1. 点击“开始”→“控制面板”→“系统”，弹出“系统属性”对话框。
2. 点击“高级”选项卡，再点击“环境变量”按钮。
3. 在“系统变量”部分找到“Path”变量，点击“编辑”。
4. 注意不要删除现有路径，按“End”键将光标移到行末，添加“;C:\Qt\4.2.3\bin” （根据实际安装的Qt版本调整）。
Python安装 ：双击python - 2.5.1.msi ，按安装程序提示操作，可选择安装路径，默认是C:\Python25 。若磁盘空间紧张，可不安装测试套件和实用脚本，但建议保留其他组件，包括Tcl/Tk 。安装完成后，可能需要重启计算机再安装PyQt。
PyQt安装 ：双击PyQt - gpl - 4.2 - Py2.5 - Qt4.2.3.exe ，若Python安装在非标准位置，需在“Choose Install Location”屏幕输入正确位置。PyQt作为Python扩展安装，其库会放在Python目录内。
测试安装 ：点击“开始”→“所有程序”→“PyQt GPL v4.2”→“Examples and Demos” ，启动标准Qt演示应用的PyQt版本，可运行其中的多个演示应用。示例代码通常安装在C:\Program Files\PyQt4\examples 。若下载了示例文件，解压pyqtbook.zip到C:盘，得到C:\pyqt目录，其中包含示例和练习答案。运行示例前，先运行makepyqt.pyw （设置路径为C:\pyqt ，勾选“Recurse”复选框，点击“Build”按钮）。

若想编写控制台应用或在控制台运行PyQt应用，可进行以下操作：
1. 点击“开始”→“所有程序”→“附件”→“Windows资源管理器”，导航到“My Computer\Local Disk (C:)\Documents and Settings\用户名\Start Menu\Programs\Accessories” 。
2. 复制并粘贴“Console (或MS - DOS Prompt)”快捷方式，重命名为“Console (PyQt)” 。
3. 右键点击新快捷方式，编辑属性，在“常规”页面将“目标”改为“cmd.exe /k C:\pyqt\pyqt.bat” 。
4. pyqt.bat文件内容如下：

set QMAKESPEC=win32-g++
path=C:\pyqt;C:\MinGW\bin;c:\Python25;c:\Python25\lib\idlelib;%path%

可使用纯文本编辑器添加一行“cd C:\pyqt” ，让控制台启动时进入该目录。若MinGW或Python安装在非标准位置，需编辑此文件以更新路径。

完成上述步骤后，就可以在Windows机器上编写和运行PyQt应用，且这些应用在Mac OS X和Linux系统上也能运行。

3. Mac OS X系统安装步骤

在Mac OS X系统上安装PyQt，必须先安装Xcode工具，因为安装PyQt需要编译器和构建工具。Xcode通常随机器附带在单独的开发者CD上，也可从http://developer.apple.com/tools/xcode 在线下载。以下步骤假设Xcode已安装。

3.1 下载

下载文件 ：
- Qt ：访问http://www.trolltech.com/developer/downloads/qt/index ，点击Qt/Mac Open Source Edition链接，在页面底部下载qt - mac - opensource - 4.2.3.dmg ，较新的版本号（如4.3.1）也适用。
- Python ：若需要安装最新版本的Python，访问http://www.python.org/download ，下载适用于Macintosh OS X的Python 2.5.1版本，如python - 2.5.1 - macosx.dmg ，2.x系列的后续生产版本（非alpha、beta或候选版本）也可以。
- SIP和PyQt ：访问http://www.riverbankcomputing.co.uk/sip/download.php ，下载源包sip - 4.6.tar.gz ；访问http://www.riverbankcomputing.co.uk/pyqt/download.php ，下载源包PyQt - mac - gpl - 4.2.tar.gz ，版本号可能更高。
- 示例文件 ：若想运行示例或查看练习答案，可从http://www.qtrac.eu/pyqtbook.html 下载并解压pyqtbook.tar.gz文件。

3.2 安装

安装顺序为：先安装Qt和Python，再安装SIP，最后安装PyQt。假设所有下载文件都在桌面，且知道管理员密码（通常是自己的密码）。

graph LR
    A[开始] --> B[安装Qt]
    B --> C{是否需要安装Python?}
    C -- 是 --> D[安装Python]
    C -- 否 --> E[安装SIP]
    D --> E[安装SIP]
    E --> F[安装PyQt]
    F --> G[结束]

Qt安装 ：双击qt - mac - opensource - 4.2.3.dmg ，按提示操作，接受默认设置并安装到标准位置。旧版本的Qt构建工具未优化，安装时间可能较长；新版本构建工具优化后速度更快。
Python安装 ：若需要安装Python，双击python - 2.5.1 - macosx.dmg ，可能会弹出包含MacPython.mpkg文件的新窗口，双击该文件启动安装程序，按提示操作，接受默认设置并安装到标准位置。若已有旧版本Python，它们将保持不变，同时会在/usr/local/bin添加两个新的Python可执行文件，如python2.5和pythonw2.5 ，分别用于终端窗口和运行GUI应用。安装完成后，检查默认Python版本，在终端输入“python -V” ，若版本不符，需手动更改设置：
1. 关闭所有现有终端窗口，打开新终端。
2. 输入“python -V”检查版本。
3. 若版本不符，在“访达”中，进入“应用程序”→“MacPython 2.5” ，启动“Python Launcher” 。
4. 打开“偏好设置”对话框，在“Settings for file type”组合框中，为“Python Scripts”和“Python Bytecode Documents”选择/usr/local/bin/python2.5 ，为“Python GUI Scripts”选择/usr/local/bin/pythonw2.5 （若下拉列表中没有这些值，需手动输入），并取消勾选“Run in a Terminal window”复选框。
SIP安装 ：在终端中执行以下命令：

cd $HOME/Desktop
tar xvfz sip-4.6.tar.gz
cd sip-4.6
python configure.py
make
sudo make install

执行“sudo make install”时，会要求输入管理员密码。
- PyQt安装 ：在终端中执行以下命令：

cd $HOME/Desktop
tar xvfz PyQt-mac-gpl-4.2.tar.gz
cd PyQt-mac-gpl-4.2
python configure.py
make
sudo make install

通过以上步骤，就可以在Mac OS X系统上完成PyQt的安装，开始进行开发工作。

PyQt安装指南（下半部分）

4. Linux和Unix系统安装概述

在大多数基于X11的Unix及类Unix系统，包括Linux和BSD上安装PyQt的相关工具，同样需要按照一定的步骤进行下载和安装。各软件包也都自带安装说明，不过这里的内容也能辅助完成安装操作。整体安装思路和Windows、Mac OS X系统有相似之处，但具体的命令和操作会因系统的不同而有所差异。

4.1 下载

下载文件及链接 ：
- PyQt ：访问http://www.riverbankcomputing.co.uk/pyqt/download.php ，根据需求选择合适的版本进行下载。版本号的选择要考虑与其他工具的兼容性，确保能顺利安装和使用。
- Qt ：访问http://www.trolltech.com/developer/downloads/qt/index ，点击相应的开源版本链接，下载适合Linux或Unix系统的Qt安装包。版本号要与PyQt中要求的一致。
- Python ：访问http://www.python.org/download ，下载适合当前系统的Python版本。同样要注意版本号与PyQt的匹配。
- SIP ：访问http://www.riverbankcomputing.co.uk/sip/download.php ，下载源包。
- 示例文件 ：若想运行示例或查看练习答案，可从http://www.qtrac.eu/pyqtbook.html 下载相应的文件包，如.tar.gz格式的文件。

软件名称	下载链接	版本要求
PyQt	http://www.riverbankcomputing.co.uk/pyqt/download.php	与其他工具版本兼容
Qt	http://www.trolltech.com/developer/downloads/qt/index	与PyQt版本一致
Python	http://www.python.org/download	与PyQt版本匹配
SIP	http://www.riverbankcomputing.co.uk/sip/download.php	-
示例文件	http://www.qtrac.eu/pyqtbook.html	-

4.2 安装

安装顺序一般是先安装Python、Qt，接着安装SIP，最后安装PyQt。

graph LR
    A[开始] --> B{是否需要安装Python?}
    B -- 是 --> C[安装Python]
    B -- 否 --> D[安装Qt]
    C --> D[安装Qt]
    D --> E[安装SIP]
    E --> F[安装PyQt]
    F --> G[结束]

Python安装 ：如果系统自带的Python版本不符合要求，需要进行更新安装。一般可以使用包管理工具，如在Debian或Ubuntu系统中使用 sudo apt-get install python2.5 （根据实际需要的版本）；在Red Hat或CentOS系统中使用 sudo yum install python2.5 。安装完成后，在终端输入 python -V 检查版本是否正确。
Qt安装 ：下载好Qt安装包后，在终端中进入下载目录，赋予安装包执行权限，如 chmod +x qt-linux-opensource-4.2.3.run （根据实际文件名），然后执行安装程序 ./qt-linux-opensource-4.2.3.run ，按照提示完成安装，可选择默认的安装路径。
SIP安装 ：在终端中执行以下命令：

cd /path/to/downloaded/sip-4.6.tar.gz
tar xvfz sip-4.6.tar.gz
cd sip-4.6
python configure.py
make
sudo make install

执行 sudo make install 时，需要输入管理员密码。
- PyQt安装 ：在终端中执行以下命令：

cd /path/to/downloaded/PyQt-linux-gpl-4.2.tar.gz
tar xvfz PyQt-linux-gpl-4.2.tar.gz
cd PyQt-linux-gpl-4.2
python configure.py
make
sudo make install

5. 安装注意事项

版本匹配 ：无论是在哪个系统上安装，都要确保各个工具的版本相互匹配。例如，PyQt的版本会决定所需Python和Qt的版本，必须严格按照要求下载和安装，否则可能会导致安装失败或程序无法正常运行。
环境变量设置 ：在Windows系统中，GPL Qt安装程序不会自动将Qt添加到系统路径，需要手动添加。在Linux和Unix系统中，有时也需要设置环境变量，确保系统能够找到所需的库文件。可以在 ~/.bashrc 或 ~/.bash_profile 文件中添加相应的路径，如 export PATH=$PATH:/path/to/qt/bin 。
磁盘空间 ：部分软件包体积较大，安装前要确保磁盘有足够的空间。在安装Python时，如果磁盘空间紧张，可以选择不安装测试套件和实用脚本，但要注意可能会影响后续的开发和调试。
管理员权限 ：在安装过程中，如执行 sudo make install 等命令时，需要输入管理员密码。确保输入的密码正确，并且具有相应的权限，否则安装可能会失败。

6. 总结

通过以上详细的步骤和说明，我们可以在Windows、Mac OS X以及Linux和Unix系统上完成PyQt及其相关工具的安装。在安装前，要明确各个工具的下载链接和版本要求；安装过程中，要按照正确的顺序进行操作，注意环境变量的设置和管理员权限的使用。安装完成后，可以通过运行示例程序来测试安装是否成功。掌握这些安装方法后，就可以在不同的操作系统上顺利开展PyQt的开发工作，创建出功能丰富的GUI应用程序。