PyQt5入门——手把手教你配置环境，快速上手GUI程序开发（Anaconda+PyCharm+Qt Designer+pyuic）

原创最新推荐文章于 2026-10-02 13:24:17 发布 7.2k 阅读 AI写同款

收录于

Python编程笔记

PyQt程序开发

虾米小馄饨

码龄12年墨衍会员 · AI 创作全网分发

1万+粉丝60篇原创

关注

超全！Python图形界面框架PyQt5使用指南！ Pyside6：Pyside是QT公司官方提供的Python包，上一版本为Pyside2，对应的是QT5，最新版命名规则进行了调整，更改为Pyside6，对应的是QT6版本。将刚才编写的PyQt5的代码（demo.py和Weather.py）拖到src/main/python文件夹下，删除原有的main.py，并将demo.py修改为main.py。Tkinter：Python内置的GUI框架，使用TCL实现，Python中内嵌了TCL解释器，使用它的时候不用安装额外的扩展包，直接import，跨平台。.. 阅读详情

AI摘要

本文详细介绍如何在Windows环境下配置PyQt5开发环境，包括安装Anaconda、PyQt5库及PyCharm，配置QtDesigner和PyUIC工具，为开发GUI应用程序打下坚实的基础。

文章目录

引言

QT是非常流行的跨平台GUI界面库，C++编写，同时支持python bindings。

利用PyQt5的强大GUI界面交互功能，结合Python编程中强大的科学计算和数据可视化，可以开发出非常漂亮、专业的GUI应用程序。在目标检测任务里常用的labelme工具，就是用基于python语言的PyQt编写的。

1. 安装python环境

本文采用conda来管理虚拟环境，anaconda包含了大量的科学包和依赖库，可以帮我们把基础依赖库安装好，便于快速上手。

1.1 安装anaconda

anaconda下载地址：

https://www.anaconda.com/products/individual#Downloads

根据操作系统，选择合适的压缩包：

在这里插入图片描述
双击下载完的压缩包（如Anaconda3-2021.05-Windows-x86_64.exe），设置安装路径，并点击Next，直至完成安装：

在这里插入图片描述

1.2 创建虚拟环境

安装完anaconda之后，启动anaconda prompt命令窗口，创建一个名为pyqt的虚拟环境。

$ conda create -n pyqt

激活虚拟环境，以后PyQt相关的依赖库都装在这个虚拟环境中，避免和其他应用的依赖库发生冲突。

$ conda activate pyqt

如果要退出pyqt虚拟环境，使用以下语句：

$ conda deactivate

注意：

如果提示python.exe无法定位程序输入点 ...C:\WINDOWS\SYSTEM32\pythoncom38.dll，可以尝试这个链接的方案： https://yunyaniu.blog.youkuaiyun.com/article/details/103557501

2. 安装PyQt库

如果没有pip，先安装下pip工具：

conda install pip

利用pip安装PyQt库：

pip3 install PyQt5
# 安装后输出 Successfully installed PyQt5-5.15.4 PyQt5-Qt5-5.15.2 PyQt5-sip-12.9.0

pip3 install pyqt5-tools
# 安装后输出 Successfully installed click-7.1.2 pyqt5-plugins-5.15.4.2.2 pyqt5-tools-5.15.4.3.2 python-dotenv-0.19.0 qt5-applications-5.15.2.2.2 qt5-tools-5.15.2.1.2

安装完成后，在...\anaconda3\envs\pyqt\Scripts路径下可以看到pyuic5、pyrcc5、pylupdate5几个可执行文件¹：

pyuic5.exe 是用于将Qt Designer（或Qt Creator内置的UI Designer）可视化设计的界面文件（.ui文件）编译转换为Python程序文件的工具软件，是使用PyQt5设计GUI程序最常用到的工具软件。
pyrcc5.exe 是用于将Qt Creator里设计的资源文件（.qrc文件）编译转换为Python程序文件的工具软件，资源文件一般存储了图标、图片等UI设计资源。
pylupdate5.exe 是用于多语言界面设计时编辑语言资源文件的工具软件。

3. 安装pycharm

本文采用pycharm作为开发工具。pycharm是一个功能非常强大的python交互式开发环境：

下载免费社区版：

https://www.jetbrains.com/pycharm/download/#section=windows

在这里插入图片描述

4. 在pycharm中配置PyQt

4.1 配置PyQt环境

创建新项目，使用conda环境，并选择pyqt环境下的python.exe：

在这里插入图片描述

4.2 添加Qt Designer可视化工具

Qt Creator可以用于C++界面开发，也可以用于设计ui文件，但是安装文件较大。如果只用python API的话，可以仅在pycharm中安装Qt Designer扩展工具，来进行界面ui设计。

打开File——Settings——Tools——External Tools，点击“+”按钮，并填下以下信息：

Name填写QtDesigner
Program中填写designer.exe的绝对路径（可以在\anaconda3\的路径下查找下，有时候安装的位置不相同）
Working directory填写当前项目路径

在这里插入图片描述
然后点击“Apply”、“OK”，完成设置。

此时，从Tools——External Tools中可以找到designer：

在这里插入图片描述

4.3 利用Qt Designer可视化工具创建ui文件

从Tools——External Tools——QtDesigner，可以启动designer.exe程序：

在这里插入图片描述
选择“Widget”创建一个部件，并从左侧Widget Box中拖动Label、Text Edit、Push Button控件完成一个部件设计，并保存这个ui设计文件。

用文本类编辑器打开*.ui文件，可以看到 ui文件实际是以xml格式保存了界面布局和控件属性：

在这里插入图片描述

4.4 添加PyUIC工具

打开File——Settings——Tools——External Tools，点击“+”按钮，并填下以下信息：

Name填写PyUIC
Program中填写pyuic5.exe的绝对路径（可以在\anaconda3\evns\xxx的路径下查找下）
Arguments中填写 $FilePath$ -o $FileDir$\$FileNameWithoutExtension$_ui.py，用于在ui文件的同级目录下生成对应的py文件
Working directory填写pyuic5.exe所在的文件夹路径

在这里插入图片描述
完成pyuic5.exe工具的配置。