Jupyter使用%matplotlib inline报错及matplotlib模块异常求助

咱们一步步来拆解解决这些Matplotlib的问题，这些报错基本都是因为安装不完整/损坏，或者Jupyter和conda环境没关联对导致的：

1. 彻底清理并重新安装Matplotlib（针对conda环境） #

既然你在conda虚拟环境安装时报错，先把环境里的Matplotlib彻底清干净再重装：

• 先激活你的conda虚拟环境：

  conda activate your_env_name
  

• 完全卸载Matplotlib，包括conda和pip的残留：

  conda remove --all matplotlib
  pip uninstall -y matplotlib
  

• 用conda-forge频道重新安装，这个频道的版本兼容性更好：

  conda install matplotlib -c conda-forge
  

2. 先在终端验证基础导入是否正常 #

安装完别着急开Jupyter，先在终端里测试基础功能，排除安装本身的问题：

import matplotlib
print(matplotlib.__version__)
import matplotlib.pyplot as plt
plt.plot([1,2,3])

如果这里能正常运行不报错，说明Matplotlib本身没问题；要是还报ModuleNotFoundError，那大概率是Jupyter没用到你装了Matplotlib的虚拟环境。

3. 把conda环境关联到Jupyter内核 #

很多时候Jupyter默认用的是系统环境，不是你的虚拟环境，按下面步骤绑定：

• 在激活的虚拟环境里装ipykernel：

  conda install ipykernel
  

• 将当前环境添加到Jupyter的内核列表：

  python -m ipykernel install --user --name=your_env_name --display-name="Python (your_env_name)"
  

• 重启Jupyter，在右上角选择对应的Python (your_env_name)内核，再测试导入和魔法命令。

4. 解决%matplotlib inline的AttributeError问题 #

如果前面都搞定了还是报这个错，可能是Matplotlib配置损坏或者版本兼容问题：

• 先重置Matplotlib的默认配置：

  import matplotlib
  matplotlib.rc_file_defaults()
  

• 再测试魔法命令：

  %matplotlib inline
  import matplotlib.pyplot as plt
  plt.plot([1,2,3])
  

• 要是还不行，试试降级到稳定版本（比如3.7.x系列），新版本偶尔会和Jupyter交互模块有bug：

  conda install matplotlib=3.7.5 -c conda-forge
  

终极排查：新建干净环境测试 #

如果上面所有步骤都没用，可能是你的原conda环境损坏了，试试新建一个干净环境：

conda create -n new_env python=3.10 matplotlib jupyter -c conda-forge
conda activate new_env
jupyter notebook

在这个新环境里测试，要是能正常用，就说明原环境有问题，直接用新环境就行。

内容的提问来源于stack exchange，提问作者Hrvoje