一、安装前的准备Matplotlib 是一个强大的 Python 绘图库用于创建各种类型的静态、动态和交互式图表。在安装之前请确认前提条件检查方式已安装 Python 3.8python3 --version已安装 pippip --version建议已安装 NumPypip show numpy如果还未安装 pip 工具可以参考 Python pip 安装与使用。二、升级 pippip 是 Python 的包管理工具。安装 Matplotlib 前建议先将 pip 升级到最新版本bashpython3 -m pip install -U pip参数说明参数含义-m pip以模块方式运行 pip确保使用当前 Python 的 pip-U升级upgrade到最新版本为什么要升级 pip新版 pip 在依赖解析、下载速度、兼容性上都更优能避免安装过程中出现奇怪的错误。三、安装 Matplotlibbashpython3 -m pip install -U matplotlib使用国内镜像加速推荐bashpython3 -m pip install -U matplotlib -i https://pypi.tuna.tsinghua.edu.cn/simple常用镜像源镜像源地址清华Simple Index阿里云Simple Index中科大Verifying - USTC Mirrors指定版本安装bashpython3 -m pip install matplotlib3.8.0建议生产环境或团队协作中建议固定版本号避免因版本升级导致的兼容性问题。四、验证安装安装完成后我们就可以通过import来导入 matplotlib 库pythonimport matplotlib查看版本号pythonimport matplotlib print(matplotlib.__version__)执行以上代码输出结果类似text3.4.2如果能看到版本号输出说明 Matplotlib 已经安装成功。在命令行中验证bashpython3 -c import matplotlib; print(matplotlib.__version__)五、动手画出第一个图表1. 最简单的折线图pythonimport matplotlib.pyplot as plt # 数据 x [1, 2, 3, 4, 5] y [2, 4, 6, 8, 10] # 绘图 plt.plot(x, y) # 显示图表 plt.show()代码解析代码作用import matplotlib.pyplot as plt导入绘图模块plt是约定俗成的别名plt.plot(x, y)绘制折线图plt.show()显示图表窗口2. 结合 NumPy 绘制正弦曲线pythonimport numpy as np import matplotlib.pyplot as plt # 生成数据0 到 2π 之间的 100 个点 x np.linspace(0, 2 * np.pi, 100) y np.sin(x) # 绘图 plt.plot(x, y) plt.title(Sine Wave) # 标题 plt.xlabel(x) # x 轴标签 plt.ylabel(sin(x)) # y 轴标签 plt.grid(True) # 显示网格 plt.show()效果一条平滑的正弦曲线带标题、坐标轴标签和网格。3. 保存图表到文件pythonimport matplotlib.pyplot as plt x [1, 2, 3, 4, 5] y [2, 4, 6, 8, 10] plt.plot(x, y) plt.savefig(my_first_plot.png, dpi150) # 保存为图片 plt.show()savefig()常用参数参数说明fname文件名支持.png、.pdf、.svg等dpi分辨率默认 100印刷建议 300bbox_inchestight自动裁剪多余空白transparentTrue背景透明六、安装常见问题排查问题现象可能原因解决方案ModuleNotFoundError: No module named matplotlib未安装或装到了其他 Python 环境检查pip -V对应的 Python 版本重新安装安装缓慢或超时默认源在国外使用国内镜像源-ipip命令不存在未安装 pip参考 pip 安装教程图表中文显示为方块未配置中文字体下一篇会专门讲解plt.show()无反应后端配置问题尝试matplotlib.use(TkAgg)或改用 Jupyter权限错误系统 Python 目录无写权限使用虚拟环境或加--user推荐使用虚拟环境bash# 创建虚拟环境 python3 -m venv venv # 激活Linux/macOS source venv/bin/activate # 激活Windows venv\Scripts\activate # 安装 Matplotlib pip install matplotlib七、安装流程图八、小结本篇你完成了 Matplotlib 的安装与初次使用升级 pippython3 -m pip install -U pip安装 Matplotlibpython3 -m pip install -U matplotlib验证安装print(matplotlib.__version__)第一个图表plt.plot()plt.show()保存图表plt.savefig()下一篇我们将深入 Matplotlib 的核心概念——Figure 与 Axes理解图表的结构组成并学习如何精细控制图表的各个元素。