Mac Ventura 13.1下Python3无法导入matplotlib问题求助

安全阿岳

2026-7-22

解决MacOS多Python版本下matplotlib模块找不到的问题

你的核心问题是多个Python版本和对应的pip版本不匹配，导致你用pip3 install安装的matplotlib，并没有安装到你实际运行的Python环境里。按以下步骤排查解决：

先明确你当前执行代码时用的是哪个Python3：
运行命令：
```
python3 --version
which python3
```
看输出是/opt/homebrew/bin/python3还是/usr/bin/python3。
用对应Python的pip重新安装matplotlib：
如果是/opt/homebrew/bin/python3，执行：
```
/opt/homebrew/bin/pip3 install matplotlib --user
```
如果是/usr/bin/python3，执行：
```
/usr/bin/pip3 install matplotlib --user
```
更稳妥的方式是直接用Python自身的pip模块安装，确保完全对应：
```
python3 -m pip install matplotlib --user
```
清理无效的Python别名：
你提到/usr/local/bin/python3是空的，这个别名只会导致混淆，直接删除：
```
unlink /usr/local/bin/python
```
长期解决方案：使用虚拟环境
多版本Python环境下，虚拟环境能彻底避免包冲突问题：
1. 创建虚拟环境：
```
python3 -m venv my_matplotlib_env
```
2. 激活虚拟环境：
```
source my_matplotlib_env/bin/activate
```
3. 此时直接安装matplotlib：
```
pip install matplotlib
```
运行代码前确保激活虚拟环境即可。