安装

报告编译问题

见 得到帮助 .

Matplotlib编译得很好，但是使用它时没有显示任何内容

首先要尝试的是 clean install 看看是否有帮助。如果没有，测试安装的最佳方法是运行脚本，而不是从Python外壳或集成开发环境（如 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 .

Linux笔记

要在系统级别安装matplotlib，我们建议您使用发行版的包管理器。这将确保Matplotlib的依赖项也将被安装。

如果出于某种原因，您不能使用包管理器，则可以使用Pypi上可用的控制盘：

python -mpip install matplotlib

或 build Matplotlib from source .

OSX音符

哪个python用于OSX？

苹果用自己的python发布了osx。 /usr/bin/python 以及它自己的Matplotlib副本。不幸的是，苹果目前安装自己的numpy、scipy和matplotlib拷贝的方式意味着这些包很难升级（请参见 system python packages ). 因此，我们强烈建议您安装一个新版本的Python，并以此作为安装NumPy和Matplotlib等库的基础。与其他有用的Python软件一起安装Matplotlib的一种方便方法是使用 Anaconda Python scientific software collection，其中包括Python本身和各种库；如果您需要一个不能从该集合获得的库，您可以使用标准方法（如 pip . 有关安装支持，请参阅Ananconda网页。

新的python安装的其他选项是 python.org 或者使用通用的OSX包管理系统安装python，例如 homebrew 或 macports . OSX上的超级用户可能希望在他们的系统上安装一个自制或macports来安装开源软件包，但完全可以将这些系统与Python二进制文件的另一个源（如Anaconda或macports）一起使用Python.org网站 Python 。

安装OSX二进制车轮

如果您使用的是来自https://www.python.org、homebrew或macports的python，那么您可以使用标准的pip安装程序以轮子的形式安装matplotlib二进制文件。

默认情况下，pip与python.org和homebrew python一起安装，但需要在macports上手动安装：

sudo port install py36-pip

一旦安装了pip，就可以从terminal.app命令行安装matplotlib及其所有依赖项：

python3 -mpip install matplotlib

(sudo python3.6 ... 在Mac端口上）。

您可能还需要安装ipython或jupyter笔记本 (python3 -mpip install ipython notebook ）

正在检查安装

Matplotlib的新版本现在应该在您的python“path”上了。在terminal.app命令行中检查：

python3 -c 'import matplotlib; print(matplotlib.__version__, matplotlib.__file__)'

你应该看到这样的东西：

3.0.0 /Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/matplotlib/__init__.py

在哪里？ 3.0.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... ，然后您将获得与OSX一起安装的python，这可能不是您想要的。再次运行检查之前，请尝试关闭并重新启动terminal.app。如果这不能解决问题，根据您要使用的Python，可以考虑重新安装python.org python，或者检查您的自制或MacPorts设置。请记住，磁盘映像安装程序只适用于python.org python，不会被其他python使用。如果这些都失败了，请 let us know .

从源安装

需要C编译器。通常，在Linux上，您需要 gcc ，应该使用发行版的包管理器安装；在macOS上，您需要 xcode; 在Windows上，您将需要Visual Studio 2015或更高版本。

使用以下方法之一克隆主源：

git clone git@github.com:matplotlib/matplotlib.git

或：

git clone git://github.com/matplotlib/matplotlib.git

并使用以下工具进行构建和安装：

cd matplotlib
python -mpip install .

如果您希望能够跟踪开发分支的变化，只需将最后一步替换为：

python -mpip install -e .

这将创建链接并在适当的位置安装命令行脚本。

然后，如果要随时更新Matplotlib，只需执行以下操作：

git pull

当你奔跑 git pull, if the output shows that only Python files have been updated, you are all set. If C files have changed, you need to run pip install -e . 再次编译它们。

有更多关于 using git 在开发人员文档中。