pip安装matplotlib后终端正常VS Code报错找不到包问题求助

问题根源 #

你遇到的报错是典型的本地文件和第三方库名冲突问题：Python导入模块时会优先搜索当前工作目录下的文件，你的桌面路径下存在一个自己创建的matplotlib.py文件，运行import matplotlib时导入的是这个空文件，而非pip安装的官方matplotlib库，自然找不到pyplot子模块。

终端运行正常是因为你在终端执行代码时的工作目录不是桌面，不会匹配到这个同名文件。

解决步骤 #

• 找到桌面路径下的matplotlib.py文件，以及同目录下生成的__pycache__文件夹，直接删除，或者重命名为不与第三方库冲突的名称（比如my_matplotlib_test.py）。
• 验证修复效果：在测试代码中加入以下代码确认导入的库路径正确：

import matplotlib
print(matplotlib.__file__)

正常情况下输出的路径应该是pyenv管理的Python目录下的site-packages里的matplotlib路径，而非你本地桌面的文件路径。

• 如果删除后仍有报错，确认VS Code当前使用的Python和pip对应：在VS Code内置终端执行以下命令，确认输出路径均为pyenv管理的对应版本路径：

which python
which pip

如果路径不匹配，使用对应Python的pip重新安装matplotlib即可：

pip install matplotlib

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