Python代码运行报错：“ModuleNotFoundError: No module named 'matplotlib'”，但pip list显示已安装
许多Python开发者在使用matplotlib库时，可能会遇到这样的问题：代码运行时提示“ModuleNotFoundError: No module named 'matplotlib'”，然而使用pip list命令却显示matplotlib已经安装。本文将针对此问题，结合代码示例，详细解释原因并提供解决方法。
问题代码示例：
import matplotlib.pyplot as plt squares = [1, 4, 9, 16, 25] fig, ax = plt.subplots() ax.plot(squares) plt.show()
运行此代码时，可能出现错误提示“ModuleNotFoundError: No module named 'matplotlib'”，即使pip list显示matplotlib已安装。
立即学习“Python免费学习笔记（深入）”；
问题根源：
此问题通常是因为运行代码的环境与使用pip list查看安装包的环境不一致导致的。pip list显示的包位于你的系统默认Python环境中，而你运行代码时，Python解释器可能使用了不同的环境，例如虚拟环境、conda环境或其他自定义环境。 使用IDE或文本编辑器时，如果没有正确配置Python解释器路径，也会出现此问题。
解决方案：
-
使用虚拟环境 (venv): 这是推荐的解决方法。虚拟环境可以创建独立的Python环境，避免包冲突。
-
创建虚拟环境： 在你的项目目录下，打开终端或命令提示符，运行以下命令：
python3 -m venv .venv # 创建名为.venv的虚拟环境
-
激活虚拟环境：
-
Linux/macOS:
source .venv/bin/activate -
Windows:
.venv\Scripts\activate
-
Linux/macOS:
-
安装matplotlib: 在激活的虚拟环境中，运行：
pip install matplotlib
- 运行代码： 现在，再运行你的Python代码，matplotlib应该能够正常工作了。
-
创建虚拟环境： 在你的项目目录下，打开终端或命令提示符，运行以下命令：
-
检查Python解释器路径: 确保你的IDE或文本编辑器已正确配置Python解释器路径，指向你安装了matplotlib的Python环境。
-
使用conda环境 (如果适用): 如果你使用conda，请确保在正确的conda环境中安装matplotlib。 使用
conda list查看已安装的包，并使用conda activate激活正确的环境。 -
重新安装matplotlib: 作为最后手段，尝试在你的系统默认Python环境中重新安装matplotlib：
pip install --upgrade matplotlib
通过以上步骤，你应该能够解决“ModuleNotFoundError: No module named 'matplotlib'”错误。 记住，使用虚拟环境是最佳实践，可以有效避免类似的包冲突问题，并保持不同项目环境的独立性。
