MacOS（M1芯片）上Matplotlib 3.6.0绘图抛出AttributeError的原因

错误原因 #

这个错误是Matplotlib在M1芯片Mac上的后端兼容性问题导致的：

• M1属于ARM架构，Matplotlib 3.6.0对ARM平台的backend_interagg后端支持不完善，该组件未正确编译或注册，导致找不到FigureCanvas属性。
• 若你的虚拟环境是通过Rosetta转译的x86 Python创建的，依赖包会存在架构不匹配问题，引发后端加载失败。
• 虚拟环境中可能残留旧版本Matplotlib依赖，与当前版本产生冲突。

解决方法 #

1. 临时切换Matplotlib后端 #

在代码开头添加后端切换语句，绕过有问题的backend_interagg：

import matplotlib
matplotlib.use('TkAgg') # 可选：'QtAgg'（GUI显示）或'Agg'（仅生成图片，非交互）
import matplotlib.pyplot as plt

x = [1,2,3,4]
y = [34, 56, 78, 21]
plt.plot(x, y)
plt.show()

2. 重新安装原生ARM版本的Matplotlib #

确保使用M1原生Python（比如Homebrew安装的Python，而非Rosetta转译的x86 Python），然后重装Matplotlib：

# 卸载现有版本
pip uninstall -y matplotlib
# 重新安装原生ARM版本
pip install matplotlib

若使用conda环境，执行：

conda uninstall -y matplotlib
conda install matplotlib

3. 升级Matplotlib到兼容版本 #

Matplotlib 3.7.0及以上版本对M1芯片的兼容性有明显优化，升级后可解决该问题：

pip install --upgrade matplotlib>=3.7.0

4. 检查虚拟环境架构 #

确认虚拟环境基于原生ARM Python创建：

• 终端执行python -c "import platform; print(platform.machine())"，输出应为arm64（而非x86_64）。
• 若输出为x86_64，说明用了Rosetta转译的Python，需重新创建基于原生ARM Python的虚拟环境。

内容的提问来源于stack exchange，提问作者Freddy Martinez Garcia