pyqt5windows安装教程

老刘

PyQt5 Windows 安装教程：从零开始装好开发环境，一步一步来

关键词：PyQt5 Windows 安装教程

如果你想在 Windows 上做桌面软件开发，PyQt5 是一个非常常用的选择。它基于 Python，把 Qt 的界面能力带到 Python 里，适合做窗口程序、工具软件、管理系统、小型桌面应用等。

很多新手在安装 PyQt5 时，最容易踩坑的地方不是 PyQt5 本身，而是 Python 版本、pIP、虚拟环境、Qt 相关依赖、IDE 配置 这些环节。下面这篇教程会按照“问题分析 → 解决方案 → 注意事项”的思路，带你把 Windows 上的 PyQt5 环境一次装好。

一、先弄清楚：PyQt5 是什么，安装前要准备什么

1. PyQt5 是什么

PyQt5 本质上是 Python 调用 Qt 图形界面库 的一套工具。它可以让你快速创建：

  • 登录窗口
  • 设置面板
  • 文件管理工具
  • 数据录入软件
  • 轻量级业务系统
  • 自动化桌面工具

2. 安装前准备

在 Windows 上安装 PyQt5，建议先准备好这几样：

  • 一台正常联网的 Windows 电脑
  • Python 3.x
  • pip 包管理器
  • 一个代码编辑器，推荐：
    • VS Code
    • PyCharm
  • 可选：虚拟环境工具 venv

3. 推荐环境

对于新手来说，建议使用：

  • Windows 10 / Windows 11
  • Python 3.10 或 3.11
  • PyQt5 最新稳定版
  • pip 安装方式
  • 虚拟环境隔离项目依赖

这样最稳，兼容性也比较好。

二、安装前先检查 Python 是否已经安装

1. 打开命令提示符

按下：

  • Win + R
  • 输入 cmd
  • 回车

然后输入下面命令检查 Python：

python --version

或者：

py --version

2. 看输出结果

如果你看到类似：

Python 3.10.8

说明 Python 已经安装好了。

如果提示：

  • “不是内部或外部命令”
  • “找不到 python”
  • “Python 不是可运行的程序”

说明电脑里还没有正确安装 Python，或者环境变量没配置好。

三、安装 Python（如果你电脑还没装）

1. 下载 Python

去 Python 官方网站下载 Windows 版本安装包，建议选择 3.10 或 3.11 的稳定版本。

2. 安装时注意两个关键选项

双击安装包后，安装界面里一定要勾选：

  • Add Python to PATH
    这个非常重要，不勾选后面命令行里可能直接用不了 Python。
  • 可以选择 Install Now
    对新手来说最省事。

3. 安装完成后验证

再次打开 cmd，输入：

python --version
pip --version

如果都能正常显示版本号，说明安装成功。

四、PyQt5 Windows 安装教程：最简单的安装方法

方法一：直接用 pip 安装 PyQt5

这是最常见、最简单的方法。

打开命令提示符，输入：

pip install PyQt5

如果你想把 Qt 的工具一起装上，也可以安装：

pip install PyQt5 PyQt5-tools

不过要注意，PyQt5-tools 在不同版本下兼容性会有差异，部分环境中不一定完全稳定。对新手来说，先装 PyQt5 就够用了。

2. 安装完成后检查

安装结束后输入：

pip show PyQt5

如果能看到版本号、安装路径等信息，说明 PyQt5 已经成功装好。

五、推荐做法：用虚拟环境安装 PyQt5，更稳更干净

很多人刚开始学 Python，喜欢直接把所有库装到系统环境里。这样短期看很方便，但后面容易出现：

  • 项目依赖冲突
  • 版本混乱
  • 一个项目升级影响另一个项目
  • 卸载麻烦

更推荐的方式是：给每个项目单独建一个虚拟环境。

1. 创建项目文件夹

比如你建一个目录：

D:\PythonProjects\PyQtDemo

2. 创建虚拟环境

进入项目目录后，执行：

python -m venv venv

这会在当前目录下生成一个 venv 文件夹，里面就是独立环境。

3. 激活虚拟环境

在 Windows 上运行：

venv\Scripts\activate

如果激活成功，命令行前面会出现 (venv)。

4. 在虚拟环境里安装 PyQt5

然后输入：

pip install PyQt5

这样 PyQt5 只安装在当前项目里，不会影响别的 Python 项目。

5. 退出虚拟环境

输入：

deactivate

即可退出。

六、安装后写一个最小测试程序，确认 PyQt5 能正常运行

安装成功不代表一定能用，最好做一次简单测试。

1. 新建一个 Python 文件

比如保存为：

test_pyqt5.py

2. 输入以下代码

import sys
from PyQt5.QtWidgets import QApplication, QWidget

app = QApplication(sys.argv)

window = QWidget()
window.setWindowTitle("PyQt5 测试窗口")
window.resize(400, 300)
window.show()

sys.exit(app.exec_())

3. 运行程序

在命令行进入文件所在目录，执行：

python test_pyqt5.py

如果弹出一个标题为“PyQt5 测试窗口”的空白窗口，说明你已经安装成功了。

七、常见问题与解决方案

问题 1：pip install PyQt5 失败，提示网络错误

常见现象：

  • 下载速度很慢
  • 一直连接超时
  • 失败提示 ReadTimeoutError
  • 无法访问某些下载源

解决方案

可以换国内镜像源安装，例如：

pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple

如果还不行，可以加上超时参数：

pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple --default-timeout=100

注意事项

  • 镜像源适合临时加速下载
  • 如果长期开发，建议熟悉 requirements.txt 管理依赖

问题 2：提示 “pip 不是内部或外部命令”

这说明 pip 没有加入环境变量，或者 Python 没装好。

解决方案

先试试：

python -m pip install PyQt5

如果 Python 能运行，这个方法通常最稳。

如果 python 也不行，就需要检查 Python 安装和 PATH 环境变量。

补充检查

输入：

where python
where pip

如果找不到路径，就说明环境变量有问题。

问题 3：安装成功了，但运行时报错找不到模块

比如：

ModuleNotFoundError: No module named 'PyQt5'

解决方案

这通常是因为：

  • 你装 PyQt5 的 Python 版本和运行代码的 Python 版本不是同一个
  • 你在虚拟环境里安装了，但运行时没激活虚拟环境
  • IDE 使用了不同解释器

处理方法

先检查当前 Python 版本：

python --version
pip --version

再检查 PyQt5 是否真的装在当前解释器里：

python -m pip show PyQt5

如果看不到信息，说明当前环境里没装成功。

问题 4：PyQt5 能安装，但 Qt Designer 不见了

很多新手安装完 PyQt5 后，发现没有图形化界面设计工具。

原因

因为 PyQt5 本体和 Qt Designer 不是一回事。
PyQt5 只是 Python 绑定库，设计器通常需要额外工具。

解决方案

你可以选择：

  1. 单独安装带工具的包
  2. 使用独立的 Qt 安装包里的 Designer
  3. 用第三方工具辅助设计 .ui 文件

如果你的重点是快速开发界面，建议直接安装完整 Qt 相关开发工具，再配合 PyQt5 使用。

八、在 PyCharm 里配置 PyQt5

很多人用 PyCharm 写 PyQt5，这里顺手讲一下。

1. 打开项目

创建一个新项目，或者打开已有 Python 项目。

2. 设置解释器

进入：

  • File
  • Settings
  • Project
  • Python Interpreter

确认当前解释器是你安装 PyQt5 的那个环境。

3. 安装 PyQt5

如果解释器选对了，可以直接在 PyCharm 的包管理里搜索并安装：

  • PyQt5

也可以打开底部 Terminal，执行：

pip install PyQt5

4. 运行测试程序

复制前面的测试代码，直接运行。如果窗口正常弹出，说明 PyCharm 配置没问题。

九、在 VS Code 里配置 PyQt5

如果你用的是 VS Code，也很简单。

1. 安装 Python 插件

在扩展商店里安装：

  • Python
  • Pylance

2. 选择解释器

按：

  • Ctrl + Shift + P

输入：

Python: Select Interpreter

选择你当前项目的 Python 或虚拟环境。

3. 安装 PyQt5

在终端输入：

pip install PyQt5

4. 测试运行

保存测试代码，直接运行即可。

十、如果你要做 Qt 设计器界面，推荐这样走

PyQt5 开发常见有两种方式：

方式一：纯代码写界面

优点：

  • 简单直接
  • 代码可维护
  • 适合小工具、逻辑明确的项目

方式二：用 .ui 文件设计界面

优点：

  • 拖拽式设计
  • 适合复杂窗口
  • 界面修改更方便

如果你是新手，建议先学纯代码方式，等熟悉后再学 .ui 文件。

十一、卸载 PyQt5 的方法

如果你装错了版本，或者想重装，可以直接卸载：

pip uninstall PyQt5

如果你还装了相关工具，也可以一起清理：

pip uninstall PyQt5-tools

卸载后再重新安装即可。

十二、安装 PyQt5 的最佳实践

1. 优先使用虚拟环境

这是最推荐的做法，能避免很多后期问题。

2. 不要随便混装多个 Python 版本

电脑里装了多个 Python，容易出现：

  • pip 指向错版本
  • 运行环境混乱
  • IDE 解释器选错

如果你是新手，建议先只保留一个稳定版本。

3. 尽量固定项目依赖

项目开发稳定后，建议导出依赖：

pip freeze > requirements.txt

以后换电脑或重装环境时，直接用：

pip install -r requirements.txt

4. 安装失败优先看报错关键词

常见关键词对应问题大致如下：

  • timeout：网络慢，换镜像源
  • No module named：环境不对
  • not recognized：命令行找不到路径
  • permission denied：权限问题，尝试管理员命令行或虚拟环境

十三、PyQt5 Windows 安装教程总结

在 Windows 上安装 PyQt5，其实流程并不复杂，核心就几步：

  1. 安装 Python
  2. 确认 python 和 pip 可用
  3. 建议创建虚拟环境
  4. 执行 pip install PyQt5
  5. 用测试代码验证是否成功
  6. 如果报错，优先检查解释器、环境变量和网络

对于大多数新手来说，最稳的组合就是：

  • Windows 10/11
  • Python 3.10/3.11
  • 虚拟环境
  • pip 安装 PyQt5
  • VS Code 或 PyCharm 作为编辑器

只要按这个顺序来，基本都能顺利把 PyQt5 环境搭好。
后面无论是写窗口程序、做自动化工具，还是开发企业桌面应用，都可以直接在这个基础上继续展开。

十四、适合新手的最终安装命令汇总

如果你只想快速照着做，可以直接看这组命令：

1. 检查 Python

python --version
pip --version

2. 创建虚拟环境

python -m venv venv

3. 激活虚拟环境

venv\Scripts\activate

4. 安装 PyQt5

pip install PyQt5

5. 测试是否安装成功

python test_pyqt5.py

十五、最后补一个新手最容易忽略的点

PyQt5 装好了以后，不代表界面设计、打包发布、中文字体、系统托盘、图标显示这些问题就自动解决了。实际开发中还会遇到：

  • 窗口图标不显示
  • 中文乱码
  • 程序打包后闪退
  • .exe 文件太大
  • 杀毒软件误报

这些都属于 PyQt5 开发的常见后续问题，通常需要配合 PyInstaller、资源文件管理、编码设置、图标打包等一起处理。

如果前期环境先搭稳，后面开发会省很多时间。

文章版权声明：文章内容均来源于各大短视频平台搜集以及修改和删减新增，如有侵权或者违规，请联系站长进行删除，如需转载或复制请以超链接形式并注明出处。

相关阅读

发表评论

快捷回复： 表情：
AddoilApplauseBadlaughBombCoffeeFabulousFacepalmFecesFrownHeyhaInsidiousKeepFightingNoProbPigHeadShockedSinistersmileSlapSocialSweatTolaughWatermelonWittyWowYeahYellowdog
验证码
评论列表 （暂无评论，3人围观）

还没有评论，来说两句吧...

目录[+]