已安装matplotlib却无法导入，求助解决ModuleNotFoundError问题

问题描述 #

已通过pip确认matplotlib已安装：

C:\Users\johns\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Python 3.10>pip show matplotlib
Name: matplotlib
Version: 3.6.0
Summary: Python plotting package
Home-page: https://matplotlib.org
Author: John D. Hunter, Michael Droettboom
Author-email: matplotlib-users@python.org
License: PSF
Location: c:\users\johns\appdata\local\packages\pythonsoftwarefoundation.python.3.10_qbz5n2kfra8p0\localcache\local-packages\python310\site-packages
Requires: contourpy, cycler, fonttools, kiwisolver, numpy, packaging, pillow, pyparsing, python-dateutil
Required-by:

但执行以下导入代码时：

from matplotlib import pyplot as plt

或

import matplotlib

均报错：

Traceback (most recent call last):
File "C:\Users\johns\OneDrive\Desktop\Università\TESI\Main.py", line 2, in <module>
from matplotlib import pyplot as plt
ModuleNotFoundError: No module named 'matplotlib'

解决方案 #

这种情况核心原因是运行脚本的Python解释器，和安装matplotlib时用的pip所属环境不匹配，按以下步骤排查解决：

• 确认当前运行脚本的Python环境
  在你的Main.py开头添加以下代码并运行，获取当前使用的Python完整路径：

  import sys
  print(sys.executable)
  

  将输出的路径和pip show matplotlib中Location字段对应的Python路径对比，若不一致，说明两个环境不统一。

• 用对应环境的pip重新安装matplotlib
  如果路径不一致，直接调用目标Python环境的pip执行安装：

  py -3.10 -m pip install matplotlib
  

  或者使用完整的pip路径执行（路径从Location字段推导）：

  "C:\Users\johns\appdata\local\packages\pythonsoftwarefoundation.python.3.10_qbz5n2kfra8p0\localcache\local-packages\python310\Scripts\pip.exe" install matplotlib
  

• 检查IDE的解释器配置
  若使用VSCode、PyCharm等IDE运行脚本，需在IDE设置中切换到安装了matplotlib的Python 3.10环境，确保解释器路径和pip show里的Location对应环境一致。

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