安裝 · Matplotlib 用戶指南

# 安裝 > 原文：[Installing](http://matplotlib.org/users/installing.html) > 譯者：[飛龍](https://github.com/) > 協議：[CC BY-NC-SA 4.0](http://creativecommons.org/licenses/by-nc-sa/4.0/) 有許多安裝 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`](https://pypi.python.org/pypi/pip/)來安裝 matplotlib 二進制。參見[安裝 MacOS 二進制輪子](http://matplotlib.org/faq/installing_faq.html#install-osx-binaries)。 ### Windows 如果你還沒有安裝 Python，我們建議使用兼容 SciPy 技術棧的 Python 分發版本，如 WinPython，Python(x, y)，Enthought Canopy 或 Continuum Anaconda，它們含有 matplotlib 和它的許多依賴，并預裝了其他有用的軟件包。對于 [Python 的標準安裝](https://www.python.org/downloads/)，可以使用`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 文件頁面](https://pypi.python.org/pypi/matplotlib/)抓取最新的`tar.gz`發布文件，或者如果你想開發 matplotlib 或只需要最新的 bug 修復版本，獲取最新的 git 版本，請見[從 git 安裝](http://matplotlib.org/faq/installing_faq.html#install-from-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 上構建](http://matplotlib.org/users/installing.html#build-osx)。如果你在 Windows 上構建，請參閱[在 Windows 上構建](http://matplotlib.org/users/installing.html#build-windows)。如果在 Linux 上使用軟件包管理器安裝依賴項，則除了庫本身之外，還可能需要安裝開發包（查找`-dev`后綴）。 #### 所需依賴 Python 2.7，3.4，3.5 或 3.6 [下載 Python](https://www.python.org/downloads/) NumPy 1.7.1（或更新） Python 的數組支持（[下載 NumPy](http://www.numpy.org/)） [setuptools](https://setuptools.readthedocs.io/en/latest/) setuptools 為 Python 包安裝提供擴展 [dateutil](http://matplotlib.org/glossary/index.html#term-dateutil) 1.1 或更新為 Python 時間日期的處理提供擴展。如果使用了`pip`，`easy_install `或者從源碼安裝，安裝器會嘗試從 PyPI 下載并安裝`python_dateutil`。 [pyparsing](https://pyparsing.wikispaces.com/) 需要為 matplotlib 的 mathtext 數學渲染提供支持。如果使用了`pip`，`easy_install `或者從源碼安裝，安裝器會嘗試從 PyPI 下載并安裝`pyparsing`。 [libpng 1.2 （或更新）](http://www.libpng.org/) 用于加載和保存 [PNG](http://matplotlib.org/glossary/index.html#term-png) 文件（[下載](http://www.libpng.org/pub/png/libpng.html)）。libong 需要 zlib。 [pytz](http://pytz.sourceforge.net/) 用于操作時區感知的日期時間。<https://pypi.python.org/pypi/pytz> [FreeType](http://matplotlib.org/glossary/index.html#term-freetype) 2.3 或更新用于讀取 TrueType 字體文件。如果使用了`pip`，`easy_install `或者從源碼安裝，安裝器會嘗試從預期位置定位 FreeType。如果找病毒奧，嘗試安裝 [pkg-config](http://matplotlib.org/users/installing.html#optional-dependencies)，用于尋找所需非 Python 庫的工具。 [cycler](http://matplotlib.org/cycler/) 0.10.1 或更新可組合的循環類，用于構造 style-cycle。 [six](https://pypi.python.org/pypi/six) 需要用于 Python 2 和 3 之間的兼容性。 #### Python 2 的依賴 [functools32](https://pypi.python.org/pypi/functools32) 需要用于 Python 2.7 上的兼容性。 [subprocess32](https://pypi.python.org/pypi/subprocess32/) 可選，僅用于 Unix。`subprocess`標準庫從 3.2+ 到 2.7 的 Backport。它提供了更好的錯誤信息和超時支持。 #### 可選的 GUI 框架這些是可選軟件包，你可能希望安裝這些軟件包來使用matplotlib 和用戶界面工具包。有關 matplotlib 可選后端和所提供功能的更多詳細信息，請參閱[什么是后端](http://matplotlib.org/faq/usage_faq.html#what-is-a-backend)。 [tk](http://matplotlib.org/glossary/index.html#term-tk) 8.3 或更新，不包括 8.6.0 和 8.6.1 TkAgg 后端使用的 TCL/Tk 窗口控件庫。版本 8.6. 0和 8.6.1 已知有問題，當以錯誤的順序關閉多個窗口時可能導致段錯誤。 [pyqt](http://matplotlib.org/glossary/index.html#term-pyqt) 4.4 或更新 Qt4 控件庫的 Python 包裝，用于 Qt4Agg 后端。 [pygtk](http://matplotlib.org/glossary/index.html#term-pygtk) 2.4 或更新 GTK 控件庫的 Python 包裝，用于 GTK 或者 GTKAgg 后端。 [wxpython](http://matplotlib.org/glossary/index.html#term-wxpython) 2.8 或更新 wx 控件庫的 Python 包裝，用于 WX 或 WXAgg 后端。 #### 可選的外部程序 [ffmpeg](https://www.ffmpeg.org/)/[avconv](https://libav.org/avconv.html) 或 [mencoder](http://www.mplayerhq.hu/design7/news.html) 需要用于動畫模塊，將輸出保存為電影格式。 [ImageMagick](http://www.imagemagick.org/script/index.php) 需要用于動畫模塊，能夠保存 GIF 動畫。 #### 可選依賴 [Pillow](http://python-pillow.org/) 如果安裝了 Pillow，matplotlib 可以讀取或寫入大部分圖像文件格式。 [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) 用于尋找所需非 Python 庫的工具。并不是嚴格需要它，但是如果庫和頭文件不在預期位置，可以使安裝更加便捷。 #### matplotlib 自帶的所需庫 [agg](http://matplotlib.org/glossary/index.html#term-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`中的構建腳本。