如果你直接使用
pip install qcustomplot_pyqt5会遇到安装失败的问题，或者尝试从源码安装也无法成功，本文提供一种更简便的
.whl文件安装方式。
要在 Windows 系统上通过
.whl文件安装
QCustomPlot_PyQt5模块，请按照以下步骤进行操作：
✅ 前提准备
- Python 已安装：确保你的系统中已正确安装 Python，并且已将其添加到环境变量 PATH 中。
-
pip 已安装：通常随 Python 一起安装，可通过运行
pip --version
验证是否可用。 -
PyQt5（无需手动安装）：虽然
QCustomPlot_PyQt5
依赖于 PyQt5，但使用.whl
安装时会自动安装兼容版本的 PyQt5，因此无需提前单独安装 PyQt5，避免版本冲突。
? 安装 .whl
文件步骤
1. 下载 .whl
文件
前往可信的镜像源下载对应版本的
.whl文件。推荐访问：
? https://www.php.cn/link/d2a83dc418ee9d6209d8356fca703f13
在页面中按
Ctrl + F搜索
QCustomPlot_PyQt5，找到适合你环境的
.whl文件并下载。
![[python]windows上通过whl文件安装QCustomPlot_PyQt5模块](https://img.php.cn/upload/article/001/503/042/175763791919770.jpg)
2. 确认文件位置
将下载的
.whl文件保存到一个明确的路径下，例如：
C:\Downloads\QCustomPlot_PyQt5-2.0.4-py3-none-any.whl
立即学习“Python免费学习笔记（深入）”；
请根据实际文件名调整后续命令。
3. 使用命令行安装
打开 命令提示符 (cmd) 或 PowerShell，执行以下操作：
cd C:\Downloads
然后运行：
pip install QCustomPlot_PyQt5-2.0.4-py3-none-any.whl
⚠️ 注意：请将文件名替换为你实际下载的 .whl 文件全名。
如果提示权限问题，可尝试以管理员身份运行命令行工具，或加上
--user参数：
pip install --user QCustomPlot_PyQt5-2.0.4-py3-none-any.whl
✅ 验证是否安装成功
打开 Python 解释器：
python
输入以下代码：
import PyQt5 from QCustomPlot_PyQt5 import QCustomPlot
若无报错信息，则说明模块已成功安装并可正常使用。
⚠️ 注意事项
-
版本匹配：确保
.whl
文件支持你的 Python 版本（如 Python 3.8、3.9 等）和系统架构（32/64 位）。 - 依赖自动处理：pip 会自动解决依赖项，包括安装合适的 PyQt5 版本。
-
路径与拼写：确保
.whl
文件路径正确，文件名输入无误，区分大小写。 - 网络问题：若安装过程中下载依赖缓慢，可配置国内镜像源（如清华、阿里云）加速。
❌ 不推荐的方式
- 源码编译安装：在 Windows 上自行编译该模块容易失败，对构建环境要求高，普通用户不建议尝试。
-
直接 pip 在线安装：由于 PyPI 上可能未上传或版本缺失，
pip install qcustomplot_pyqt5
很可能失败。
建议始终使用
.whl文件方式进行安装，简单、高效、成功率高。
