安装指南¶
注解
如果你想为这个项目做贡献，建议你 install the latest development version .
目录
安装正式版本¶
Matplotlib及其依赖项作为MacOS、Windows和Linux发行版的车轮包提供：
python -m pip install -U pip
python -m pip install -U matplotlib
如果此命令导致Matplotlib从源代码处编译，并且编译有问题，可以添加 --prefer-binary 选择Matplotlib的最新版本，其中有用于操作系统和Python的预编译控制盘。
注解
以下后端是现成的：Agg、ps、pdf和svg
Python通常附带tk绑定，TkAgg使用这些绑定。
要支持其他GUI框架、LaTeX渲染、保存动画和更大的文件格式选择，您需要安装 additional dependencies .
虽然不需要，但我们建议安装 IPython 供交互使用。要轻松安装完整的科学python堆栈，请参见 科学 Python 分布 下面。
测试数据¶
轮子 (*.whl ） PyPI download page 不包含测试数据或示例代码。
如果您想尝试Matplotlib源代码分发中的许多演示，请下载 *.tar.gz 归档并查找 examples 子目录。
要运行测试套件：
Matplotlib的第三方分布¶
科学 Python 分布¶
Anaconda 和 ActiveState 对于Windows、MacOS和普通Linux平台来说，这是一个非常好的选择。 WinPython 是Windows用户的一个选项。所有这些分布都包括matplotlib和 lots 其他有用的（数据）科学工具。
Linux：使用包管理器¶
如果您使用的是Linux，那么您可能更喜欢使用包管理器。Matplotlib几乎为每个主要的Linux发行版打包。
- Debian/Ubuntu：
sudo apt-get install python3-matplotlib - Fedora：
sudo dnf install python3-matplotlib - 红帽：
sudo yum install python3-matplotlib - Arch：
sudo pacman -S python-matplotlib
从源安装¶
如果您对Matplotlib开发、运行最新的源代码感兴趣，或者只是想自己构建所有东西，那么从源代码构建Matplotlib并不难。抓住最新 tar.gz 释放文件 the PyPI files page ，或者，如果您想开发Matplotlib或只需要最新的bug修复版本，请获取最新的git版本，然后参阅 从源安装 .
Matplotlib可以从源目录安装，方法很简单：
python -m pip install .
我们提供了一个 setup.cfg 可用于自定义生成过程的文件。例如，要使用哪个默认后端，Matplotlib附带的一些可选库是否已安装，等等。这个文件对于那些打包Matplotlib特别有用。
依赖关系¶
Matplotlib需要以下依赖项：
- Python （>=3.6）
- NumPy (>= 1.15)
- setuptools
- cycler （＞0.0.0）
- dateutil （＞2.1）
- kiwisolver （＞1.0.0）
- Pillow (>= 6.2)
- pyparsing (>=2.0.3)
或者，您也可以安装许多软件包以启用更好的用户界面工具包。见 什么是后端？ 有关可选matplotlib后端及其提供的功能的更多详细信息。
- Tk (>= 8.3, !=8.6.0或8.6.1）：用于基于Tk的后端。
- PyQt4 （＞4.6）或 PySide （>=1.0.3） [1]: 对于基于Qt4的后端。
- PyQt5 或 PySide2: 对于基于Qt5的后端。
- PyGObject：用于基于GTK3的后端 [2].
- wxPython （>=4） [3]: 对于基于wx的后端。
- pycairo （>=1.11.0）或 cairocffi （>=0.8）：用于GTK3和/或基于cairo的后端。
- Tornado：用于WebAgg后端。
| [1] | PySide不能在Linux上安装pip（但可以安装conda）。 |
| [2] | 如果使用pip（而不是conda），则必须从源代码构建PyGObject；请参阅https://pygobject.readthedocs.io/en/latest/devguide/dev_environ.html。 |
| [3] | 如果在Linux上使用pip（而不是conda），则必须从https://wxpython.org/pages/downloads/。 |
为了更好地支持动画输出格式和图像文件格式、 Latex 等，可以安装以下内容：
- ffmpeg: 为了保存电影。
- ImageMagick: 用于保存动画gif。
- LaTeX (with cm-super ） GhostScript (>=9.0) ：用于用 Latex 渲染文本。
- fontconfig （>=2.7）：用于在Linux上检测系统字体。
FreeType和Qhull¶
Matplotlib依赖于 FreeType （>=2.3）、字体呈现库等 Qhull （>=2015.2），用于计算三角剖分的库。默认情况下（在AIX上除外），Matplotlib下载并构建自己的FreeType副本（这对于运行测试套件是必需的，因为不同版本的FreeType栅格化字符的方式不同），并使用自己的Qhull副本。
要强制Matplotlib使用系统中已安装的FreeType或Qhull的副本，请创建 setup.cfg 包含以下内容的文件：
[libs]
system_freetype = true
system_qhull = true
赛前 python -m pip install . .
在这种情况下，您需要安装FreeType和Qhull库以及头文件。这可以使用包管理器实现，例如对于FreeType：
# Pick ONE of the following:
sudo apt install libfreetype6-dev # Debian/Ubuntu
sudo dnf install freetype-devel # Fedora
brew install freetype # macOS with Homebrew
conda install freetype # conda, any OS
（对Qhull进行相应调整）。
在Linux和macOS上，也建议安装 pkg-config, 用于定位FreeType的辅助工具：
# Pick ONE of the following:
sudo apt install pkg-config # Debian/Ubuntu
sudo dnf install pkgconf # Fedora
brew install pkg-config # macOS with Homebrew
conda install pkg-config # conda
# Or point the PKG_CONFIG environment variable to the path to pkg-config:
export PKG_CONFIG=...
如果不使用pkg config（特别是在Windows上），可能需要显式设置include path（到库头）和link path（到库），如果它们不在标准位置。这可以通过使用标准环境变量来实现--在Linux和OSX上：
export CFLAGS='-I/directory/containing/ft2build.h'
export LDFLAGS='-L/directory/containing/libfreetype.so'
在Windows上：
set CL=/IC:\directory\containing\ft2build.h
set LINK=/LIBPATH:C:\directory\containing\freetype.lib
注解
Matplotlib始终使用以下库的自己的副本：
Agg反粒度几何C++渲染引擎；ttconv：TrueType字体实用程序。