Python: PyQt5在Pycharm中的配置

来源：网络 2025-09-28 21:29 275

文章背景：Qt是众多GUI组件中极其优秀的组件，不仅可以开发桌面应用，还可以开发移动应用，所以Qt是非常值得学习的组件。下面就来学习如何在Pycharm中配置PyQt5。

Python版本：3.7.5

Pycharm版本: PyCharm Community Edition 2021.3.2

操作系统：win10

1 安装两个模块2 配置Pycharm2.1 添加Qt Designer工具2.2 添加PyUIC工具2.3 添加PyRCC工具3 示例代码

1 安装两个模块

（1）在Pycharm中新建一个项目，取名为：QtDemo。

（2）打开命令符提示符窗口，切换到指定项目Scripts对应的文件夹（XXXPycharmProjectsQtDemovenvScripts），分别运行如下代码，安装pyqt5模块和pyqt5-tools这两个模块。

pip --default-timeout=100 install pyqt5 -i http://pypi.douban.com/simple --trusted-host pypi.douban.com

pip --default-timeout=100 install pyqt5-tools -i http://pypi.douban.com/simple --trusted-host pypi.douban.com

2 配置Pycharm

下面开始配置PyQt5。打开File -> Settings…。然后打开Tools->External Tools，点击界面的左上角的+号，开始添加外部工具。在这里我们主要是添加三个外部工具。

Qt Designer designer.exe 打开Qt Designer界面，对软件的界面进行设计。
PyUIC pyuic5.exe 将Qt Designer设计的UI文件转换为.py文件。
PyRCC pyrcc5.exe 将资源文件如图片等转成python代码能识别的文件。

2.1 添加Qt Designer工具

（1） Name: 可以填Qt Desiner。随意设置，方便记忆即可。

（2）Program: designer.exe路径。一般是在QtDemovenvLibsite-packagesqt5_applicationsQtin文件夹内。

程序：C:Users13978AppDataLocalProgramsPythonPython38Libsite-packagesqt5_applicationsQtindesigner.exe

Name处输入QtDesigner（可以设计自己喜欢的名字），这个工具是图形化设计工具，Program处输入designer.exe的地址，我的是:D:AnacondaLibsite-packagesqt5_applicationsQtindesigner.exe,可以自己在电脑的搜索栏搜索designer.exe的路径然后复制。Working directory处输入$FileDir$。点击确定就好了

2.2 添加PyUIC工具

配置Pyuic-另一方法 Pyuic 是 PyQt 或 PySide 提供的工具，用于将 Qt Designer 生成的 .ui 文件（XML 格式的界面设计文件）转换为可直接调用的 Python 代码。例如，PyQt5 使用 pyuic5，而 PySide6 使用 pyside6-uic。转换后的 Python 文件包含 UI 的类定义，开发者可以继承或嵌入该代码，实现界面与逻辑的分离，从而更高效地开发 Qt 应用。程序：python.exe 实参：-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py 工作目录：$FileDir$ https://blog.csdn.net/a1397852386/article/details/148243615

（1） Name: 可以填PyUIC。随意设置，方便记忆即可。

（2）Program: pyuic5.exe路径。一般是在Script文件夹内。

Program:pyuic5.exe安装路径，例如:D:\Anaconda\Scripts\pyuic5.exe Arguments:$FileName$ -o $FileNameWithoutExtension$.py Working directory:$ProjectFileDir$

实参：$FileName$ -o $FileNameWithoutExtension$.py

工作目录： $FileDir$

2.3 添加PyRCC工具

Pyrcc 是 PyQt 或 PySide 框架中用于将 Qt 资源文件（.qrc）编译为 Python 模块的工具。它将 .qrc 文件中定义的资源（如图片、图标、UI 文件等）转换为二进制数据并嵌入到 Python 代码中，方便在应用程序中直接调用这些资源，无需依赖外部文件路径。使用命令 pyrcc5（PyQt5）或 pyside6-rcc（PySide6）即可完成编译，生成的文件通常以 _rc.py 结尾。

配置Pyrcc-另一方法

程序：C:\Users\13978\AppData\Local\Programs\Python\Python38\python.exe 实参：-m PyQt5.pyrcc_main $FileName$ -o $FileNameWithoutExtension$_rc.py 工作目录：$FileDir$

https://blog.csdn.net/a1397852386/article/details/148243615

（1） Name: 可以填PyRCC。随意设置，方便记忆即可。

（2）Program: pyrcc5.exe路径。一般是在Script文件夹内。

实参：$FileName$ -o $FileNameWithoutExtension$.py

工作目录： $FileDir$

Pycharm中通过pyqt5设计GUI界面 (1)利用代码创建GUI界面新建first.py，输入以下代码 from PyQt5 import QtWidgets # 导入PyQt5部件 import sys app = QtWidgets.QApplication(sys.argv) # 建立application对象 first_window = QtWidgets.QWidget() # 建立窗体对象 first_window.resize(500, 450) # 设置窗体大小 first_window.setWindowTitle("我的第一个GUI程序") # 设置窗体标题 first_window.show() # 显示窗体 sys.exit(app.exec()) # 运行程序 AI运行代码运行，结果显示如下就成功了

(2) 利用QtDesigner工具生成一个GUI界面，并用PyUIC将生成的.ui文件转换成.py文件

选择Tools->ExternalTools->QtDesigner，进入界面，选择MainWindow，点击创建后点左上角文件保存,如保存为hello.ui

回到主界面就会发现项目下生成了hello.ui文件，如下图

右键单击hello.ui，选择ExternalTools->PyUIC就会生成hello.ui对应的hello.py文件了。

3 示例代码

（1）在Qt Designer界面，设计UI界面，得到test.ui文件，并借助PyUIC转化，得到test.py文件。

（2）在QtDemo项目文件夹内新建一个py文件，取名为：qt5demo.py。在该文件内，输入如下内容：

import sys
import test
from PyQt5.QtWidgets import QApplication, QMainWindow

if __name__ == '__main__':
    app = QApplication(sys.argv)
    MainWindow = QMainWindow()
    ui = test.Ui_Dialog()
    ui.setupUi(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_())

本文网址：http://blog.yxrj.top/xxsj/1933.html