PyCharm安装matplotlib失败：换阿里云源解决

脚本专家

在 Python 开发中，终端已经通过 pip3 安装 matplotlib，但 PyCharm 里 import 仍然报错，是常见的解释器环境不一致问题。原文给出的处理思路是：不要只在终端反复安装，而是进入 PyCharm 的 Project Interpreter 中安装 matplotlib，让包进入当前项目实际使用的解释器环境。

例如终端执行过：

2. pip3 install matplotlib

复制代码

如果 PyCharm 仍然无法引入，可以按下面的流程排查和修复。

一、在 PyCharm 中定位 Project Interpreter

打开 Preferences，找到 Project Interpreter，点击加号添加包。这个入口决定了后续安装的包是否会被当前项目识别。

二、搜索并安装 matplotlib

在输入框中搜索 matplotlib，选中要安装的包，然后点击下方的 install package。安装完成后，PyCharm 当前项目解释器中才会拥有该库。

三、下载慢时切换阿里云仓库

如果发现安装特别慢，可以点击 manage repositories 切换下载地址为阿里云。原文中的做法是删除默认下载地址，只保留阿里云地址。切换完仓库后，先刷新一次，再点击安装。

四、安装报错时添加 trusted-host

安装时可能会报错，可以在右侧 Options 中添加：

2. --trusted-host mirrors.aliyun.com

复制代码

该参数用于让 pip 信任指定主机，常用于处理镜像源证书或 HTTPS 校验导致的安装失败。

五、备选方案：把 http 改为 https

原文还提到另一种尝试：将 repository 地址从 http 改为 https。这个办法在某个包安装时验证可用，可以作为排查镜像源协议问题时的备选方案。

六、建议的排查顺序

1. 确认终端 pip3 安装过的 matplotlib，在 PyCharm Project Interpreter 中是否存在。
2. 不存在时，在 Project Interpreter 中搜索 matplotlib 并安装。
3. 安装慢，切换阿里云仓库，刷新后再安装。
4. 报错，在 Options 中加入 --trusted-host mirrors.aliyun.com。
5. 仍异常，尝试把仓库地址由 http 改为 https。

按上述步骤处理后，matplotlib 可以成功安装。核心问题是 PyCharm 的包管理依赖 Project Interpreter：终端 pip3 对应的环境与 PyCharm 当前项目解释器不一致时，就会出现终端安装正常、IDE 引入报错的现象。