PyQt5入门教程:从安装到构建简单应用
简介
PyQt5是一个功能强大的Python绑定库,用于Qt应用程序框架。它允许我们使用Python语言快速开发跨平台的桌面应用程序。本教程将引导你完成PyQt5的安装、配置,并带你创建一个简单的图形用户界面(GUI)应用程序。
Part 1: 安装PyQt5
在你的开发环境中安装PyQt5:
-
打开终端或命令提示符。
-
创建并激活虚拟环境(可选,但推荐):
python -m venv myenv myenv\Scripts\activate # Windows source myenv/bin/activate # macOS/Linux
-
使用pip安装PyQt5和pyqt5-tools:
pip install PyQt5 pyqt5-tools
如果下载速度慢,可以指定国内镜像源:
pip install PyQt5 pyqt5-tools -i https://pypi.tuna.tsinghua.edu.cn/simple
-
使用
pip list
确认PyQt5是否已安装。
Part 2: PyCharm配置PyQt5
在PyCharm中配置PyQt5,以便使用Qt Designer设计UI:
-
打开PyCharm,进入“File” -> “Settings” -> “Tools” -> “External Tools”。
-
点击“+”添加新工具,配置Qt Designer、PyUIC和Pyrcc。
-
QtDesigner:
- 名称:QtDesigner
- 程序:
designer.exe
的路径(例如:C:\Python39\Lib\site-packages\PyQt5\Qt\bin\designer.exe
)。 - 工作目录:
$FileDir$
。
-
PyUIC:
- 名称:PyUIC
- 程序:Python解释器的路径。
- 实参:
-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py
。 - 工作目录:
$FileDir$
。
-
Pyrcc:
- 名称:Pyrcc
- 程序:Python解释器的路径。
- 实参:
-rcc $FileName$ -o $FileNameWithoutExtension$_rc.py
。 - 工作目录:
$FileDir$
。
-
-
配置完成后,你可以通过PyCharm访问Qt Designer。
Part 3: 设计第一个UI
使用Qt Designer设计UI:
- 打开Qt Designer,选择“Main Window”并创建新窗口。
- 在“Widget Box”中选择组件,拖拽到设计画布上。
- 使用“属性编辑器”修改组件的属性。
- 完成设计后,使用快捷键
Ctrl + R
预览UI。
Part 4: 将UI转换为Python代码
-
在Qt Designer中完成设计后,保存
.ui
文件。 -
使用PyUIC工具将
.ui
文件转换为Python代码:pyuic5 your_ui_file.ui -o output_py_file.py
-
创建一个新的Python脚本,例如
main.py
,引入QApplication和QMainWindow,并使用转换后的UI类创建应用程序:import sys from PyQt5.QtWidgets import QApplication, QMainWindow import your_ui_file # 替换为你的.ui转换后的模块名class MainWindow(QMainWindow, your_ui_file.Ui_MainWindow):def __init__(self):super().__init__()self.setupUi(self)# 添加按钮点击事件self.pushButton.clicked.connect(self.on_pushButton_clicked)def on_pushButton_clicked(self):print("按钮被点击了!")if __name__ == '__main__':app = QApplication(sys.argv)mainWindow = MainWindow()mainWindow.show()sys.exit(app.exec_())
-
运行
main.py
,你将看到设计的用户界面,并且按钮点击事件已经可以正常工作。
结语
本教程为你提供了一个完整的PyQt5入门流程,从安装到配置,再到设计UI和编写应用逻辑。PyQt5的世界非常广阔,你可以继续探索更多的组件和布局,甚至学习如何将应用程序打包发布。希望这个教程能够帮助你开启PyQt5的学习之旅。