安装#

安装官方版本#

Matplotlib 版本可作为 macOS、Windows 和 Linux on PyPI的轮包提供。使用安装它 pip：

python -m pip install -U pip
python -m pip install -U matplotlib

如果此命令导致从源代码编译 Matplotlib 并且编译出现问题，您可以添加--prefer-binary以选择最新版本的 Matplotlib，其中有一个适用于您的 OS 和 Python 的预编译轮。

笔记

以下后端开箱即用：Agg、ps、pdf、svg

Python 通常附带 TkAgg 使用的 tk 绑定。

为了支持其他 GUI 框架、LaTeX 渲染、保存动画和更多的文件格式选择，您可以安装Optional dependencies。

第三方发行版#

各种第三方为其环境提供 Matplotlib。

康达包#

Matplotlib 可通过anaconda 主频道获得

conda install matplotlib

以及通过conda-forge 社区频道

conda install -c conda-forge matplotlib

Python 发行版#

Matplotlib 是主要 Python 发行版的一部分：

Linux 包管理器#

如果您使用的是 Linux 发行版附带的 Python 版本，您可以通过包管理器安装 Matplotlib，例如：

  • Debian / Ubuntu：sudo apt-get install python3-matplotlib

  • 软呢帽：sudo dnf install python3-matplotlib

  • 红色的帽子：sudo yum install python3-matplotlib

  • 拱：sudo pacman -S python-matplotlib

安装每晚构建#

Matplotlib 在 scipy-wheels-nightly Anaconda Cloud 组织上提供夜间开发构建轮。pip可以通过将 scipy-wheels-nightly 指定为要查询的包索引来安装这些轮子：

python -m pip install \
  --upgrade \
  --pre \
  --index-url https://pypi.anaconda.org/scipy-wheels-nightly/simple \
  --extra-index-url https://pypi.org/simple \
  matplotlib

从源安装#

如果您有兴趣为 Matplotlib 开发做出贡献，运行最新的源代码，或者只是想自己构建所有东西，那么从源代码构建 Matplotlib 并不难。

首先，您需要安装Dependencies。

需要交流编译器。通常，在 Linux 上，您需要gcc使用发行版的包管理器安装它；在 macOS 上，您将需要xcode；在 Windows 上，您将需要Visual Studio 2015 或更高版本。

对于使用 Visual Studio 的用户，请确保选择了“使用 C++ 进行桌面开发”，并且选择并安装了最新的 MSVC、“适用于 Windows 的 C++ CMake 工具”以及与您的 Windows 版本兼容的 Windows SDK。默认情况下，它们应该在“可选”子标题下被选中，但是从源代码构建 matplotlib 是必需的。

获取最新开发版本开始贡献的最简单方法是转到 git存储库 并运行：

git clone https://github.com/matplotlib/matplotlib.git

或者：

git clone git@github.com:matplotlib/matplotlib.git

如果您正在开发，最好在可编辑模式下进行。如果以这种方式安装，pytest 的测试发现仅适用于 Matplotlib 的原因。此外，可编辑模式允许您的代码更改立即传播到您的库代码，而无需重新安装（尽管您必须重新启动 python 进程/内核）：

cd matplotlib
python -m pip install -e .

如果您不开发，可以从源目录安装它，只需简单的（只需替换最后一步）：

python -m pip install .

要运行测试，您需要安装一些额外的依赖项：

python -m pip install -r requirements/dev/dev-requirements.txt

然后，如果您想随时更新您的 Matplotlib，只需执行以下操作：

git pull

运行时，如果输出显示只有 Python 文件已更新，则一切就绪。如果 C 文件已更改，则需要再次运行以编译它们。git pullpip install -e .

在开发者文档中有更多关于使用 git的信息。

警告

本节中的以下说明适用于非常自定义的 Matplotlib 安装。请谨慎操作，因为这些说明可能会导致您的构建产生意外行为和/或导致本地测试失败。

如果您想从 tarball 构建，请从PyPI 文件页面获取最新的tar.gz发布文件。

我们提供了一个mplsetup.cfg文件，您可以使用它来自定义构建过程。例如，使用哪个默认后端，是否安装了 Matplotlib 附带的一些可选库，等等。这个文件对那些打包 Matplotlib 的人特别有用。

如果您在 Windows 上构建自己的 Matplotlib 轮子（或 sdists），请注意，您复制到源代码树中的任何 DLL 也将被打包。

安装开发#

请参阅为开发设置 Matplotlib。

常见问题#

报告编译问题#

请参阅获得帮助。

Matplotlib 编译得很好，但我使用它时什么都没有显示#

首先要尝试的是全新安装，看看是否有帮助。如果没有，测试安装的最佳方法是运行脚本，而不是从 python shell 或集成开发环境（如IDLE ）以交互方式工作，这会增加额外的复杂性。打开 UNIX shell 或 DOS 命令提示符并运行，例如：

python -c "from pylab import *; set_loglevel('debug'); plot(); show()"

这将为您提供有关 Matplotlib 正在加载哪些后端、版本信息等的更多信息。此时，您可能需要确保您了解 Matplotlib 的配置 过程，该过程由matplotlibrc包含内部说明和 Matplotlib 后端概念的配置文件控制。

如果您仍有问题，请参阅获得帮助。

如何完全删除 Matplotlib #

有时，可以通过全新安装包来解决 Matplotlib 的问题。为了完全删除已安装的 Matplotlib：

  1. 从您的Matplotlib 配置目录中删除缓存。

  2. 从安装目录中删除任何 Matplotlib 目录或鸡蛋。

OSX 注释#

适用于 OSX 的 Python 是什么？#

Apple 为 OSX 提供了自己的 Python、in/usr/bin/python和自己的 Matplotlib 副本。不幸的是，Apple 目前安装自己的 NumPy、Scipy 和 Matplotlib 副本的方式意味着这些包很难升级（请参阅系统 python 包）。出于这个原因，我们强烈建议您安装新版本的 Python，并将其用作安装 NumPy 和 Matplotlib 等库的基础。将 Matplotlib 与其他有用的 Python 软件一起安装的一种便捷方法是使用Anaconda Python 科学软件集合，其中包括 Python 本身和各种库；如果您需要集合中没有的库，您可以使用标准方法（例如pip ）自行安装. 有关安装支持，请参阅 Anaconda 网页。

全新 Python 安装的其他选项是来自 python.org的标准安装程序，或使用通用 OSX 包管理系统（如homebrew或macports ）安装 Python 。OSX 上的高级用户可能希望在他们的系统上使用 homebrew 或 macport 来安装开源软件包，但完全可以将这些系统与 Python 二进制文件的另一个源一起使用，例如 Anaconda 或 Python.org Python。

安装 OSX 二进制轮子#

如果您使用来自https: //www.python.org、Homebrew 或 Macports 的 Python，那么您可以使用标准 pip 安装程序以轮子的形式安装 Matplotlib 二进制文件。

pip 默认与 python.org 和 Homebrew Python 一起安装，但需要在 Macports 上手动安装

sudo port install py38-pip

安装 pip 后，您可以从 Terminal.app 命令行安装 Matplotlib 及其所有依赖项：

python3 -m pip install matplotlib

您可能还想安装 IPython 或 Jupyter notebook ( )。python3 -m pip install ipython notebook

检查您的安装#

新版本的 Matplotlib 现在应该在您的 Python“路径”上。在 Terminal.app 命令行中检查：

python3 -c 'import matplotlib; print(matplotlib.__version__, matplotlib.__file__)'

你应该看到类似的东西

3.6.0 /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/matplotlib/__init__.py

你刚刚安装的 Matplotlib 版本在哪里3.6.0，后面的路径取决于你使用的是 Python.org Python、Homebrew 还是 Macports。如果您看到另一个版本，或者您收到类似的错误

Traceback (most recent call last):
  File "<string>", line 1, in <module>
ImportError: No module named matplotlib

然后通过运行检查 Python 二进制文件是否是您所期望的

which python3

如果您得到类似的结果/usr/bin/python...，那么您将使用 OSX 安装 Python，这可能不是您想要的。在再次运行检查之前尝试关闭并重新启动 Terminal.app。如果这不能解决问题，根据您要使用的 Python，考虑重新安装 Python.org Python，或检查您的 homebrew 或 macports 设置。请记住，磁盘映像安装程序仅适用于 Python.org Python，不会被其他 Python 获取。如果所有这些都失败了，请告诉我们。