安装#

安装官方发行版#

Matplotlib 发行版在 PyPI 上以 macOS,Windows 和 Linux 的 wheel 软件包提供.使用 pip 安装它:

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

如果此命令导致 Matplotlib 从源代码编译并且编译出现问题,您可以添加 --prefer-binary 来选择 Matplotlib 的最新版本,该版本具有适用于您的操作系统和 Python 的预编译 wheel.

备注

以下后端可以直接使用:Agg,ps,pdf,svg

Python 通常附带 tk 绑定,TkAgg 会使用这些绑定.

为了支持其他 GUI 框架,LaTeX 渲染,保存动画和更多文件格式选择,您可以安装 optional dependencies .

第三方发行版#

各种第三方为其环境提供 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

安装 nightly build#

Matplotlib 在 scientific-python-nightly-wheels Anaconda Cloud organization 上提供 nightly 开发构建 wheel.可以通过指定 scientific-python-nightly-wheels 作为要查询的包索引,使用 pip 安装这些 wheel:

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 构建,请从 the PyPI files page 下载最新的 tar.gz 发行文件.

如果您在 Windows 上构建自己的 Matplotlib wheel(或 sdist),请注意,您复制到源代码树中的任何 DLL 也会被打包.

配置构建和行为默认值#

我们提供一个 meson.options 文件,其中包含可用于自定义构建过程的选项.例如,使用哪个默认后端,是否安装 Matplotlib 附带的一些可选库,等等.这些选项对于那些打包 Matplotlib 的人特别有用.

可以通过以下方式配置库的某些行为默认方面:

可以通过 rcParams file 配置默认绘图外观和行为.

依赖项#

如果您使用诸如 pip 或 conda 之类的包管理器安装 Matplotlib,则会自动安装强制性依赖项;因此,此列表主要用于参考和故障排除.

常见问题解答#

报告编译问题#

请参阅 获取帮助 .

Matplotlib 编译正常,但是使用时没有任何显示#

首先要尝试的是 clean install ,看看是否有帮助.如果不行,测试安装的最佳方法是运行脚本,而不是从 Python shell 或集成开发环境(如 IDLE )以交互方式工作,因为这些环境会增加额外的复杂性.打开一个 UNIX shell 或 DOS 命令提示符并运行,例如:

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

这将为您提供关于 Matplotlib 加载了哪些后端,版本信息等的更多信息.此时,您可能需要确保您了解 Matplotlib 的 configuration 过程,该过程由 matplotlibrc 配置文件管理,该文件包含其中的说明以及 Matplotlib 后端的概念.

如果您仍然遇到问题,请参阅 获取帮助 .

如何完全删除 Matplotlib#

有时,通过全新安装软件包可以解决 Matplotlib 的问题.为了完全删除已安装的 Matplotlib:

  1. 从您的 Matplotlib configuration directory 中删除缓存.

  2. 从您的 installation directory 中删除任何 Matplotlib 目录或 eggs.

macOS 说明#

macOS 使用哪个 Python?#

Apple 在 macOS 中自带了 Python,位于 /usr/bin/python ,以及 Matplotlib 的副本.不幸的是,Apple 当前安装 NumPy,Scipy 和 Matplotlib 副本的方式意味着这些软件包很难升级(请参阅 system python packages ).因此,我们强烈建议您安装一个全新的 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 二进制 wheels#

如果您使用的是来自 https://www.python.org,Homebrew 或 Macports 的 Python,那么您可以使用标准的 pip 安装程序以 wheels 的形式安装 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 拾取.如果所有这些都失败了,请 let us know .

故障排除#

获取 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 设置配置目录和缓存目录的位置.

On this page