为什么MacOS下Python 3.10无法运行matplotlib？如何解决？

AI 小北

2026-10-3

问题原因

你系统中同时存在Python2.7、Python3.9、Python3.10三个版本，默认的pip和python3命令绑定的是Python3.9，所以直接执行pip install只会把包安装到Python3.9的依赖目录，Python3.10读不到这个路径下的包，就会报模块不存在的错误。

解决步骤

第一步，先确认Python3.10的可执行路径，终端执行命令：
```
which python3.10
```
同时可以执行python3.10 --version确认返回版本为3.10.x，证明你本地的Python3.10可以正常调用。
第二步，使用Python3.10对应的pip安装matplotlib，执行命令：
```
python3.10 -m pip install matplotlib
```
这种写法会强制调用Python3.10自带的pip工具，依赖包会直接安装到Python3.10对应的site-packages目录，不会和其他版本冲突。
第三步，验证安装结果，执行命令：
```
python3.10 -c "import matplotlib;print(matplotlib.__version__)"
```
如果没有报错且正常输出版本号，说明Python3.10环境下的matplotlib已经安装成功。
如果你需要在Sublime Text 3中使用Python3.10运行代码，需要额外配置对应的编译系统：
1. 打开Sublime Text，依次点击菜单栏「Tools > Build System > New Build System」
2. 清空默认生成的内容，替换为以下配置，注意要把/usr/local/bin/python3.10替换为你第一步执行which python3.10得到的实际路径
```
{
  "cmd": ["/usr/local/bin/python3.10", "-u", "$file"],
  "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
  "selector": "source.python"
}
```
1. 将配置文件保存为Python3.10.sublime-build，之后运行代码时在Build System列表中选择该配置即可。