新手得看--Python+PyCharm+PyQt5环境配置（详细图文演示）

一．前言

好久没有写过这么基础的博客啦，因为环境大家一般就配置一次，之后就是使用了，但是就是这个环境配置劝退了一些要学PyQt5的朋友，本篇详细介绍Python+PyCharm+PyQt5环境配置，带大家实现0到1的突破！
本次演示目标为：
Python3.8
PyCharm社区版
PyQt5==5.15.11

二．相关知识

1.Python

Python 是一种高级、易学、通用的编程语言，以简洁的语法和强大的功能著称。它支持多种编程范式（面向对象、函数式、过程式），并拥有丰富的标准库和第三方模块，广泛应用于Web开发、数据分析、人工智能、自动化脚本等领域。其设计哲学强调代码可读性，例如使用缩进来定义代码块，使得代码清晰易维护。Python 是开源的，拥有活跃的社区支持，适合初学者和专业开发者使用。

2.PyCharm

PyCharm是一种Python IDE（Integrated Development Environment，集成开发环境），带有一整套可以帮助用户在使用Python语言开发时提高其效率的工具，比如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制。此外，该IDE提供了一些高级功能，以用于支持Django框架下的专业Web开发。

3.PyQt5

PyQt5 是一个用于创建图形用户界面（GUI）的 Python 库，基于 Qt 框架开发。它提供了丰富的控件（如按钮、文本框、表格等）和强大的功能（多线程、网络通信、数据库交互等），支持跨平台运行（Windows、macOS、Linux）。开发者可以用 PyQt5 快速构建复杂的桌面应用程序，同时结合 Python 的简洁语法和 Qt 的高性能渲染，适用于数据分析工具、多媒体软件、自动化程序等开发。

三．环境安装配置

1.Python

1.安装

通过我给出的Python安装程序按照下图操作即可一键安装Python3.8，记得勾选“Add Python 3.8 to PATH”

当出现下图的界面，则证明Python安装成功，点击Close关闭即可

2.验证

按下组合键win+r打开终端，然后在终端输入python -V
按下回车查看当前python版本

使用pip-V
查看当前pip版本

可以看到安装的pip版本是19.2.3

3.配置镜像

为了更快地安装三方包，需要配置镜像，操作也很简单直接在终端输入

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple

即可配置pip镜像为阿里源

4.升级pip

升级pip的目的是为后面安装pyqt5环境做准备

pip install -U pip

5.安装pyqt5

pip install pyqt5

最后我们安装的pyqt5版本为5.15.11版

6.安装pyqt5工具

pyqt5工具里包括但不限于：qt设计师、pyuic、pyrcc

pip install qt5_applications

2.PyCharm

这里以pycharm-2525.1.1.1为例给大家演示PyCharm的安装

1.安装

双击打开安装包，按照中文引导进行安装即可

点击下一步，选择好安装目录

配置我是按照下图勾选的，大家可以按需勾选

这里直接下一步

安装过程

安装完成，我们选择默认的“否”点击完成

2.验证

打开PyCharm

然后创建一个项目按照下面配置，环境选择现有的pip环境即可

项目创建完成

3.PyQt5工具

这里演示如何在PyCharm中配置PyQt5工具：QT设计师、Pyuic、Pyrcc

1.配置QT设计师

Qt 设计师（Qt Designer）是 Qt 框架提供的可视化 UI 设计工具，允许开发者通过拖拽组件的方式快速构建图形用户界面（GUI）。它支持创建 .ui 文件（基于 XML 格式），可被 PyQt 或 PySide 直接加载或转换为 Python 代码（使用 pyuic5 或 pyside6-uic）。Qt 设计师提供丰富的控件库、布局管理、样式编辑和信号槽预览功能，大幅提升界面开发效率，同时保持跨平台兼容性（Windows/macOS/Linux）。

首先打开文件-设置-工具-外部工具

点击右侧+号

这时候插一句：
大家把Python的路径先复制出来，具体来说是在终端输入pip -V然后复制出前面这一段路径即可，这个路径一会要用到

按下图进行配置：

程序：C:\Users\13978\AppData\Local\Programs\Python\Python38\Lib\site-packages\qt5_applications\Qt\bin\designer.exe
实参：空
工作目录：
C:\Users\13978\AppData\Local\Programs\Python\Python38\Lib\site-packages\qt5_applications\Qt\bin

2.配置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$

3.配置Pyrcc

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

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

四．总结

本次使用详细的图文演示了Python+PyCharm+PyQt5环境配置，能够给新手提供帮助，能够帮助他们快速搭建本地开发环境、大家开始学的时候千万不要被配置环境吓到，其实很简单~