已安装matplotlib但VS Code提示No module named matplotlib的解决咨询

核心原因 #

VS Code当前用的Python解释器，和你装matplotlib时pip对应的解释器不是同一个环境——Jupyter自动关联了有matplotlib的环境，但VS Code没选对。

具体解决步骤 #

1. 切换到正确的Python解释器 #

• 看VS Code底部状态栏，点击显示Python版本的区域（比如Python 3.9.6），弹出所有可用解释器列表。
• 选和Jupyter Notebook一致的环境（比如你装matplotlib的虚拟环境、Anaconda环境，或者系统里对应pip的那个Python版本）。

2. 给当前VS Code用的环境重新装matplotlib #

如果找不到对应环境，或者想确保安装到位：

• 打开VS Code终端，先查当前终端的Python版本：

  python --version
  # 系统是Mac/Linux的话，可能要换成python3
  python3 --version
  

• 用对应版本的pip安装：

  python -m pip install matplotlib
  # 对应上面的python3的话，用这个
  python3 -m pip install matplotlib
  

  用-m pip能保证调用的是当前Python对应的pip，不会搞混环境。

3. 检查工作区的解释器配置 #

如果是多环境项目，可能工作区有专属配置：打开.vscode/settings.json，确认python.defaultInterpreterPath（新版）或者python.pythonPath（旧版）指向的是装有matplotlib的解释器路径。
比如：

{
    "python.defaultInterpreterPath": "/usr/local/bin/python3.10"
}

验证 #

重新运行代码：

from matplotlib import pyplot as plt
plt.plot([1,2,3])
plt.show()

能正常弹出图表就说明问题解决了。

内容的提问来源于stack exchange，提问作者Hüseyin