Windows下Python3.10用pip安装matplotlib提示qhull下载失败如何解决

报错是因为pip安装时触发了matplotlib源码编译流程，编译所需的qhull依赖包网络拉取失败导致安装中断。你之前将qhull包放入全局缓存目录不生效，是因为pip构建时只会读取临时解压的matplotlib源码根目录下的build文件夹，不会读取全局缓存路径的文件。

方案1：安装预编译二进制包（优先推荐，操作最简单） #

Windows下无需手动编译源码，直接安装官方预构建的wheel包即可规避该问题：

• 先清理之前安装失败的残留：
  pip uninstall -y matplotlib
• 升级pip到最新版本，避免旧版本无法匹配Python 3.10对应的预编译包：
  python -m pip install --upgrade pip
• 指定仅安装二进制包，跳过源码编译流程：
  pip install --only-binary :all: matplotlib
  如果下载速度慢，可以在命令末尾添加国内源参数：-i https://pypi.tuna.tsinghua.edu.cn/simple

方案2：手动本地源码编译 #

如果你确实需要从源码编译安装，按以下步骤操作：

• 下载对应版本的matplotlib源码包到本地，解压到任意路径，例如D:\matplotlib_source
• 将你下载的qhull压缩包解压，把解压后的整个文件夹放到刚才的源码目录下的build文件夹内（如果build文件夹不存在就手动创建）
• 打开命令提示符进入源码根目录，执行本地安装命令：
  pip install .

方案3：conda环境安装 #

如果你使用的是Anaconda/Miniconda管理Python环境，直接通过conda命令安装会自动处理所有依赖关联，不会触发该报错：
conda install matplotlib

内容的提问来源于stack exchange，提问作者Luis Fernández