导入matplotlib.pyplot时出现ImportError，求解决方案

这种情况我碰到过好几次，虽然你已经尝试了重装和更新，但大概率是下面这些容易被忽略的问题，一个个排查应该能解决：

• 环境依赖冲突
  有时候conda环境里的其他包（比如numpy、pillow、scipy）和matplotlib的版本不兼容，单纯更新matplotlib没法解决全局的依赖矛盾。
  解决办法：创建一个干净的测试环境，只安装matplotlib试试：

  conda create -n test_matplotlib python=3.10 matplotlib
  conda activate test_matplotlib
  python -c "import matplotlib.pyplot as plt"
  

  如果这个测试环境能成功导入，说明你原来的环境存在依赖冲突，要么逐步排查冲突包（可以用conda list对比两个环境的包版本），要么直接迁移到新环境开发。

• 系统级底层依赖缺失
  matplotlib依赖一些系统库（比如libpng、freetype），尤其是在Linux/macOS上，如果这些库未安装或版本过低，会导致导入失败，而conda/pip的安装过程可能不会主动提示这个问题。
  解决办法：

  • Ubuntu/Debian系统：执行sudo apt-get install libpng-dev libfreetype6-dev python3-tk
  • macOS（用Homebrew）：执行brew install libpng freetype
  • Windows系统一般conda安装会自动包含这些依赖，但如果是pip安装的，建议切换回conda重新安装。

• 残留的损坏安装缓存
  重装时如果没彻底清理旧的缓存文件，残留的损坏文件会干扰新安装的正常运行。
  解决办法：先彻底卸载并清理缓存，再重新安装：

  # 彻底卸载matplotlib
  conda remove --all matplotlib
  # 清理conda所有缓存
  conda clean -a
  # 重新安装
  conda install matplotlib
  

• 后端渲染引擎故障
  matplotlib默认的图形后端（比如TkAgg、Qt5Agg）可能在你的系统上无法正常初始化，导致导入时崩溃。
  解决办法：先尝试用无图形界面的后端测试是否能导入：

  import matplotlib
  matplotlib.use('Agg')  # 指定无图形后端
  import matplotlib.pyplot as plt
  

  如果这个能成功，说明是后端的问题：

  • Linux用户可以安装Tkinter依赖（sudo apt-get install python3-tk）
  • 或者修改matplotlib配置文件，将默认后端改成你系统支持的（比如Qt5Agg，需要先安装pyqt5）

• Python版本不兼容
  如果你用的Python版本太新（比如刚发布的3.12）或者太旧（比如3.7以下），可能和当前安装的matplotlib版本不兼容。
  解决办法：查看matplotlib官方支持的Python版本，然后调整版本匹配。比如安装指定版本组合：

  conda install matplotlib=3.7 python=3.10
  

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