PyQt在Windows安装需先配置Python环境（建议3.6+），确保pip可用，根据需求选择版本：PyQt5（Python 3.6-3.10）或PyQt6（3.8+），推荐pip安装，命令为pip install PyQt5或pip install PyQt6，国内用户可加-i https://pypi.douban.com/simple加速，若遇依赖问题，可单独安装PyQt5-tools/PyQt6-tools，或下载对应Python版本的whl文件本地安装，安装后通过import PyQt5验证是否成功。
PyQt是Python语言中基于Qt框架的GUI（图形用户界面）开发工具包，它将强大的Qt功能与Python的简洁性结合，让开发者能够快速构建跨平台的桌面应用程序，在Windows系统上安装PyQt是开发GUI应用的第一步，本文将详细介绍从环境准备到安装验证的全流程，帮助新手顺利完成配置。
安装前准备：Python环境配置
PyQt是基于Python的库,因此安装PyQt前需确保系统已正确配置Python环境，以下是具体步骤：
下载Python安装包
- 访问Python官方下载页面：https://www.python.org/downloads/windows/
- 根据Windows系统版本（64位或32位）选择对应的安装包（推荐下载最新稳定版，如Python 3.10+）。
安装Python并添加到环境变量
- 双击下载的安装包,勾选 “Add Python to PATH”（关键步骤！），这将允许在命令行中直接使用
python命令。 - 点击“Install Now”进行默认安装，或“Customize installation”自定义安装路径（建议默认路径，避免权限问题）。
- 安装完成后,打开命令行（按
Win+R输入cmd），输入以下命令验证Python是否安装成功：python --version
若显示Python版本号（如
Python 3.10.8），则表示安装成功。
升级pip（可选但推荐）
pip是Python的包管理工具,确保其为最新版本可避免后续安装依赖问题：
python -m pip install --upgrade pip
PyQt安装：选择版本与执行安装
PyQt主要有两个常用版本：PyQt5（基于Qt5，稳定且文档丰富）和PyQt6（基于Qt6，支持新特性，适合新项目），本文以更常用的PyQt5为例，PyQt6安装步骤类似（仅将包名替换为pyqt6）。
安装PyQt5核心库
在命令行中执行以下命令：
pip install pyqt5
若下载速度较慢,可使用国内镜像源（如清华大学、阿里云）：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyqt5
安装PyQt5-tools（推荐）
pyqt5-tools包含实用工具，如Qt Designer（可视化界面设计器）、PyUIC（将.ui文件转为.py文件）等，能极大提升开发效率：
pip install pyqt5-tools
验证PyQt5安装
安装完成后,在命令行中输入以下命令测试是否可正常导入：
python -c "import PyQt5; print(PyQt5.QtCore.QT_VERSION_STR)"
若输出Qt版本号（如15.2），则表示PyQt5安装成功。
PyQt开发工具配置：使用Qt Designer
Qt Designer是PyQt的可视化界面设计工具，通过拖拽组件即可生成界面（.ui文件），再转换为Python代码（.py文件），避免手动编写布局代码，以下是配置步骤：
启动Qt Designer
安装pyqt5-tools后，Qt Designer通常位于Python安装目录的Lib\site-packages\pyqt5_tools\Qt\bin下，可直接双击designer.exe启动，或在命令行输入：
designer
创建界面文件
- 启动后选择“Main Window”（主窗口）或“Dialog”（对话框）模板，点击“Create”。
- 通过右侧组件栏（如“Buttons”“Widgets”）拖拽按钮、标签、输入框等到画布上。
- 设计完成后,点击“File”→“Save”，保存为
.ui文件（如main.ui）。
将.ui文件转换为.py文件
使用PyUIC工具将.ui文件转换为Python代码：
pyuic5 -x main.ui -o main.py
-x：表示生成的代码可直接运行（包含if __name__ == "__main__":部分）。-o：指定输出文件名（如main.py）。
转换后的main.py可直接运行，或作为模块导入到主程序中。
常见问题与解决
安装时提示“Permission denied”
原因：未以管理员身份运行命令行。
解决：右键点击命令行工具（如“CMD”或“PowerShell”），选择“以管理员身份运行”，再执行安装命令。
提示“Could not find a version that satisfies the requirement”
原因
