MacOS下VSCode运行Python代码提示matplotlib模块未找到（已用pip3安装）

核心原因 #

你用pip3 install matplotlib安装的模块，和VSCode/终端运行脚本时调用的Python解释器版本不匹配，导致解释器找不到已安装的模块。

解决步骤 #

• 第一步：确认pip3对应的Python路径
  在终端运行以下命令，查看pip3关联的Python解释器位置：

  pip3 --version
  

  输出会类似：pip 23.3.1 from /usr/local/lib/python3.9/site-packages/pip (python 3.9)，这里的python 3.9就是pip3对应的Python版本，对应的解释器路径可通过which python3.9验证。

• 第二步：让VSCode使用正确的解释器
  点击VSCode左下角状态栏显示的Python版本号，在弹出的列表中选择第一步确认的那个Python版本（比如Python 3.9.x）。

• 第三步：强制用目标Python解释器安装matplotlib
  如果上面的步骤还没解决，直接用目标Python的-m pip命令重新安装，确保模块装到正确的环境：

  /usr/local/bin/python3 -m pip install matplotlib
  

  （把/usr/local/bin/python3换成你第一步确认的Python路径）

• 验证安装是否成功
  在终端运行以下命令，确认matplotlib能被正确导入：

  /usr/local/bin/python3 -c "import matplotlib.pyplot as plt; print('导入成功')"
  

额外提示 #

如果你的Mac里有多个Python版本（比如系统自带的Python、brew安装的Python），建议用虚拟环境隔离不同项目的依赖，避免版本冲突。

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