安裝#

安裝官方發佈版本#

Matplotlib 發佈版本以 wheel 套件的形式在 PyPI 上提供，適用於 macOS、Windows 和 Linux。使用 pip 安裝它

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

如果此命令導致 Matplotlib 從原始碼編譯，並且編譯出現問題，您可以新增 --prefer-binary 以選擇適用於您的作業系統和 Python 的最新 Matplotlib 版本，該版本有預編譯的 wheel。

注意

以下後端開箱即用：Agg、ps、pdf、svg

Python 通常會隨附 tk 綁定，TkAgg 使用這些綁定。

為了支援其他 GUI 框架、LaTeX 渲染、儲存動畫和更多檔案格式，您可以安裝選用相依性。

第三方發行版本#

各種第三方為其環境提供 Matplotlib。

Conda 套件#

Matplotlib 可透過 *anaconda main channel* 取得

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

  • Fedora： sudo dnf install python3-matplotlib

  • Red Hat： sudo yum install python3-matplotlib

  • Arch： sudo pacman -S python-matplotlib

安裝每夜建置版本#

Matplotlib 在 scientific-python-nightly-wheels Anaconda Cloud 組織上提供每夜開發建置 wheel。這些 wheel 可以使用 pip 安裝，方法是指定 scientific-python-nightly-wheels 作為要查詢的套件索引

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

從原始碼安裝#

安裝以進行開發

如果您想要貢獻 Matplotlib 或需要安裝最新的開發程式碼，請遵循設定 Matplotlib 以進行開發中的說明。

以下說明是針對生產用途從原始碼安裝。一般來說，*不*建議這樣做；請盡可能使用預先建置的套件。請謹慎行事，因為這些說明可能會導致您的建置產生非預期的行為，和/或導致本機測試失敗。

在嘗試安裝 Matplotlib 之前，請先安裝相依性。

若要從 tarball 建置，請從 PyPI 檔案頁面下載最新的 *tar.gz* 發行檔案。

如果您在 Windows 上建置自己的 Matplotlib wheel（或 sdists），請注意，您複製到原始碼樹狀結構中的任何 DLL 也會被封裝。

設定建置和行為預設值#

我們提供一個 meson.options 檔案，其中包含可用於自訂建置過程的選項。例如，要使用哪個預設後端、是否安裝 Matplotlib 隨附的某些選用程式庫等等。這些選項對於封裝 Matplotlib 的人特別有用。

可以使用以下方式設定程式庫的一些行為預設值：

可以使用rcParams 檔案設定預設繪圖外觀和行為

相依性#

如果您使用 pip 或 conda 等套件管理員安裝 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 目錄或 eggs。

macOS 說明#

macOS 使用哪個 Python？#

Apple 在 macOS 中隨附自己的 Python，位於 /usr/bin/python，以及自己的 Matplotlib 副本。遺憾的是，Apple 目前安裝其 NumPy、Scipy 和 Matplotlib 副本的方式表示這些套件難以升級（請參閱系統 Python 套件）。因此，我們強烈建議您安裝全新的 Python 版本，並將其作為安裝 NumPy 和 Matplotlib 等程式庫的基礎。安裝 Matplotlib 和其他有用的 Python 軟體的一種便捷方法是使用 Anaconda Python 科學軟體集合，其中包含 Python 本身和各種程式庫；如果您需要集合中沒有提供的程式庫，您可以使用標準方法（例如 *pip*）自行安裝。請參閱 Anaconda 網頁以取得安裝支援。

全新安裝 Python 的其他選項是來自 python.org 的標準安裝程式，或使用通用的 macOS 套件管理系統（如 homebrew 或 macports）安裝 Python。macOS 的進階使用者可能希望在其系統上使用 homebrew 或 macports 來安裝開放原始碼軟體套件，但完全可以將這些系統與另一個 Python 二進位來源（例如 Anaconda 或 Python.org Python）一起使用。

安裝 macOS 二進位 wheel#

如果您使用來自 https://www.python.org、Homebrew 或 Macports 的 Python，則可以使用標準 pip 安裝程式以 wheel 的形式安裝 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.10.0 /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/matplotlib/__init__.py

其中 3.10.0 是您剛安裝的 Matplotlib 版本，而後續的路徑則取決於您使用的是 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... 的結果，那麼您使用的是 macOS 預裝的 Python，這可能不是您想要的。請嘗試關閉並重新啟動 Terminal.app，然後再次執行檢查。如果這樣無法解決問題，請根據您想使用的 Python 版本，考慮重新安裝 Python.org Python，或者檢查您的 Homebrew 或 Macports 設定。請記住，磁碟映像安裝程式僅適用於 Python.org Python，而其他 Python 版本不會採用。如果所有這些方法都失敗，請告知我們。

疑難排解#

取得 Matplotlib 版本#

若要找出您的 Matplotlib 版本號碼，請導入它並列印 __version__ 屬性：

>>> import matplotlib
>>> matplotlib.__version__
'0.98.0'

matplotlib 安裝位置#

您可以透過導入 Matplotlib 並列印 __file__ 屬性來找出 Matplotlib 的安裝目錄：

>>> import matplotlib
>>> matplotlib.__file__
'/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/__init__.pyc'

matplotlib 設定和快取目錄位置#

每個使用者都有一個 Matplotlib 設定目錄，其中可能包含一個 matplotlibrc 檔案。若要找出您的 matplotlib/ 設定目錄，請使用 matplotlib.get_configdir()：

>>> import matplotlib as mpl
>>> mpl.get_configdir()
'/home/darren/.config/matplotlib'

在類 Unix 系統上，此目錄通常位於您的 HOME 目錄下的 .config/ 目錄中。

此外，使用者還有一個快取目錄。在類 Unix 系統上，預設情況下此目錄與設定目錄是分開的。若要找出您的 .cache/ 目錄，請使用 matplotlib.get_cachedir()：

>>> import matplotlib as mpl
>>> mpl.get_cachedir()
'/home/darren/.cache/matplotlib'

在 Windows 上，設定目錄和快取目錄是相同的，預設情況下位於您的 Documents and Settings 或 Users 目錄中。

>>> import matplotlib as mpl
>>> mpl.get_configdir()
'C:\\Documents and Settings\\jdhunter\\.matplotlib'
>>> mpl.get_cachedir()
'C:\\Documents and Settings\\jdhunter\\.matplotlib'

如果您想使用不同的設定目錄，您可以透過在您的 MPLCONFIGDIR 環境變數中指定位置來做到 -- 請參閱 在 Linux 和 macOS 中設定環境變數。請注意，MPLCONFIGDIR 會同時設定設定目錄和快取目錄的位置。

在本頁面