安裝
原文：Installing
譯者：飛龍
有許多安裝 matplotlib 的不同方法，最好的方法取決于你使用的操作系統，已經安裝的內容以及如何使用它。 為了避免涉及本頁上的所有細節（和潛在的復雜性），有幾個方便的選項。
安裝預構建包
多數平臺：Python 科學分發包
第一個選項是使用已經內置 matplotlib 的預打包的 Python 分發包。 Continuum.io Python 分發包（Anaconda 或 miniconda）和 Enthought 分發包（Canopy）都是『在 Windows，OSX 和主流 Linux 平臺開箱即用并正常工作』的出色選擇。 這兩個分發包包括 matplotlib 和許多其他有用的工具。
Linux：使用你的包管理器
如果你是用 Linux，你可能更傾向于使用包管理器。matplotlib 是用于多數主流 Linux 發行版的包。
- Debian / Ubuntu：
sudo apt-get install python-matplotlib - Fedora / Redhat：
sudo yum install python-matplotlib
Mac OSX：使用pip
如果你使用 MacOS，你可以使用 Python 標準安裝程序pip來安裝 matplotlib 二進制。參見安裝 MacOS 二進制輪子。
Windows
如果你還沒有安裝 Python，我們建議使用兼容 SciPy 技術棧的 Python 分發版本，如 WinPython，Python(x, y)，Enthought Canopy 或 Continuum Anaconda，它們含有 matplotlib 和它的許多依賴，并預裝了其他有用的軟件包。
對于 Python 的標準安裝，可以使用pip安裝 matplotlib ：
python -m pip install -U pip setuptools
python -m pip install matplotlib
如果沒有為所有用戶安裝 Python 2.7 或 3.4，則需要安裝 Microsoft Visual C++ 2008（對于 Python 2.7 為 64 位或 32 位）或 Microsoft Visual C++ 2010（對于 Python 3.4 為 64 位或 32 位）再分發包。
Matplotlib 依賴于 Pillow 來讀取和保存 JPEG，BMP 和 TIFF 圖像文件。 Matplotlib 需要 MiKTeX 和 GhostScript 來使用LaTeX渲染文本。動畫模塊需要 FFmpeg，avconv，mencoder 或 ImageMagick。
以下后端應該開箱即用：agg，tkagg，ps，pdf 和 svg。對于其他后端，你可能需要安裝 pycairo，PyQt4，PyQt5，PySide，wxPython，PyGTK，Tornado 或 GhostScript。
TkAgg 可能是來自標準 Python shell 或 IPython 的，用于交互式的最佳后端。它被啟用為官方二進制文件的默認后端。 Windows 不支持 GTK3。
PyPI 下載頁面上的 Windows 輪子（* .whl）不包含測試數據或示例代碼。如果你想嘗試 matplotlib 源代碼中的許多演示，請下載*.tar.gz文件并查看examples子目錄。要運行測試套件，請將源代碼發行版中的lib\matplotlib\tests和lib\mpl_toolkits\tests目錄分別復制到sys.prefix\Lib\site-packages\matplotlib和sys.prefix\Lib\site-packages\mpl_toolkits，并安裝 nose，mock，Pillow，MiKTeX，GhostScript，ffmpeg，avconv，mencoder，ImageMagick 和 Inkscape。
從源碼安裝
如果你有興趣為 matplotlib 開發做貢獻，運行最新的源代碼，或者只是想自己構建一切，從源代碼構建 matplotlib 并不困難。 從 PyPI 文件頁面抓取最新的tar.gz發布文件，或者如果你想開發 matplotlib 或只需要最新的 bug 修復版本，獲取最新的 git 版本，請見從 git 安裝。
源代碼遵守標準環境變量 CC，CXX，PKG_CONFIG。 這意味著如果你的工具鏈有前綴，你可以設置它們。 這可以用于交叉編譯。
export CC=x86_64-pc-linux-gnu-gcc export CXX=x86_64-pc-linux-gnu-g++ export PKG_CONFIG=x86_64-pc-linux-gnu-pkg-config
一旦你滿足的了面的具體需求（主要是 Python、NumPy、libpng 和 freetype），你就可以構建 matplotlib 了：
cd matplotlib
python setup.py build
python setup.py install
我們提供與setup.py一起使用的setup.cfg文件，你可以使用它來自定義構建過程。 例如，要使用的默認后端，是否安裝 matplotlib 附帶的某些可選庫，等等。 這個文件會對那些包裝 matplotlib 的東西特別有用。
如果已經為非標準設施安裝了必備組件，并需要通知 matplotlib 它們在哪里，請編輯setupext.py并將基本路徑添加為sys.platform的basedir字典條目。 例如，如果某些所需庫的頭文件位于/some/path/include/someheader.h中，請在你的平臺的basedir列表中輸入/some/path。
構建需求
這些是外部軟件包，你需要在安裝 matplotlib 之前安裝它們。 如果你在 OSX 上構建，請參閱在 OSX 上構建。 如果你在 Windows 上構建，請參閱在 Windows 上構建。 如果在 Linux 上使用軟件包管理器安裝依賴項，則除了庫本身之外，還可能需要安裝開發包（查找-dev后綴）。
所需依賴
Python 2.7，3.4，3.5 或 3.6
NumPy 1.7.1（或更新）
Python 的數組支持（下載 NumPy）
setuptools 為 Python 包安裝提供擴展
dateutil 1.1 或更新
為 Python 時間日期的處理提供擴展。如果使用了pip，easy_install或者從源碼安裝，安裝器會嘗試從 PyPI 下載并安裝python_dateutil。
需要為 matplotlib 的 mathtext 數學渲染提供支持。如果使用了pip，easy_install或者從源碼安裝，安裝器會嘗試從 PyPI 下載并安裝pyparsing。
用于加載和保存 PNG 文件（下載）。libong 需要 zlib。
用于操作時區感知的日期時間。https://pypi.python.org/pypi/pytz
FreeType 2.3 或更新
用于讀取 TrueType 字體文件。如果使用了pip，easy_install或者從源碼安裝，安裝器會嘗試從預期位置定位 FreeType。如果找病毒奧，嘗試安裝 pkg-config，用于尋找所需非 Python 庫的工具。
cycler 0.10.1 或更新
可組合的循環類，用于構造 style-cycle。
需要用于 Python 2 和 3 之間的兼容性。
Python 2 的依賴
需要用于 Python 2.7 上的兼容性。
可選，僅用于 Unix。subprocess標準庫從 3.2+ 到 2.7 的 Backport。它提供了更好的錯誤信息和超時支持。
可選的 GUI 框架
這些是可選軟件包，你可能希望安裝這些軟件包來使 用matplotlib 和用戶界面工具包。 有關 matplotlib 可選后端和所提供功能的更多詳細信息，請參閱什么是后端。
tk 8.3 或更新，不包括 8.6.0 和 8.6.1
TkAgg 后端使用的 TCL/Tk 窗口控件庫。
版本 8.6. 0和 8.6.1 已知有問題，當以錯誤的順序關閉多個窗口時可能導致段錯誤。
pyqt 4.4 或更新
Qt4 控件庫的 Python 包裝，用于 Qt4Agg 后端。
pygtk 2.4 或更新
GTK 控件庫的 Python 包裝，用于 GTK 或者 GTKAgg 后端。
wxpython 2.8 或更新
wx 控件庫的 Python 包裝，用于 WX 或 WXAgg 后端。
可選的外部程序
需要用于動畫模塊，將輸出保存為電影格式。
需要用于動畫模塊，能夠保存 GIF 動畫。
可選依賴
如果安裝了 Pillow，matplotlib 可以讀取或寫入大部分圖像文件格式。
用于尋找所需非 Python 庫的工具。并不是嚴格需要它，但是如果庫和頭文件不在預期位置，可以使安裝更加便捷。
matplotlib 自帶的所需庫
agg 2.4
C++ 渲染引擎。 matplotlib 靜態鏈接到 agg 模板源碼，所以它除了 matplotlib 之外，不會影響你的系統的任何東西。
qhull 2012.1
用于計算 Delaunay 三角測量的庫。
ttconv
TureType 字體工具。
在 Linux 上構建
使用你的系統包管理器來安裝依賴最為簡單。
如果你使用 Debian/Ubuntu，可以使用以下命令在獲取需要用于構建 matplotlib 的所有依賴：
sudo apt-get build-dep python-matplotlib
如果你使用 Fedora/RedHat，你可以使用以下命令：
su -c "yum-builddep python-matplotlib"
這不會構建 matplotlib，但這會安裝所需依賴。這會使從源碼構建變得容易。
在 OSX 上構建
由于可以獲取libpng和freetype需求（darwinports，fink，/usr/X11R6）的不同位置，不同的架構（例如 x86，ppc，universal）和不同的 OSX 版本 10.4 和 10.5），OSX 的構建情況很復雜。我們建議你使用我們對 OSX 版本所做的方式來構建：從tarball或git倉庫獲取源代碼，并按照README.osx中的說明進行操作。
在 Windows 上構建
https://www.python.org 上發布的 Python ，使用 VS2008 編譯 3.3 之前的版本，使用 VS2010 編譯 3.3，并且使用 VS2015 編譯 3.5 和 3.6。 建議使用相同的編譯器編譯 Python 擴展。
由于沒有規范的 Windows 包管理器，從源代碼構建freetype，zlib和libpng的方法被記錄為matplotlib-winbuild中的構建腳本。
