Matplotlib 3.4.0（2021年3月26日）的新功能 #

有关自上次修订以来的所有问题和拉取请求列表，请参阅 3.10.3 (2025年5月8日) 的 GitHub 统计数据。

创建新 Axes 的函数行为已更改（pyplot.axes, pyplot.subplot, figure.Figure.add_axes, figure.Figure.add_subplot）。过去，这些函数会检测您是否尝试使用与当前图中已存在的 Axes 相同的关键字参数创建 Axes，如果是，它们将返回现有 Axes。现在，pyplot.axes、figure.Figure.add_axes 和 figure.Figure.add_subplot 将始终创建新的 Axes。pyplot.subplot 将继续重用具有匹配子图规格和相同 kwargs 的现有 Axes。

相应地，获取当前 Axes 的函数行为已更改（pyplot.gca, figure.Figure.gca）。过去，这些函数接受关键字参数。如果关键字参数与已存在的 Axes 匹配，则返回该 Axes，否则使用这些关键字参数创建新的 Axes。现在，只有在当前图中完全没有 Axes 时才考虑关键字参数。在未来的版本中，这些函数将根本不接受关键字参数。

`add_subplot`/`add_axes` 增加了 axes_class 参数 #

特别是，mpl_toolkits Axes 子类现在可以通过惯用的方式使用，例如 fig.add_subplot(axes_class=mpl_toolkits.axislines.Axes)

Subplot 和 subplot2grid 现在可以与受限布局一起使用 #

constrained_layout 依赖于每个逻辑布局上的一个 GridSpec。以前，pyplot.subplot 和 pyplot.subplot2grid 每次调用时都会添加一个新的 GridSpec，因此与 constrained_layout 不兼容。

现在 subplot 会尝试重用 GridSpec，如果行数和列数与图中已有的顶层 GridSpec 相同，即 plt.subplot(2, 1, 2) 将使用与 plt.subplot(2, 1, 1) 相同的 GridSpec，并且 Figure 的 constrained_layout=True 选项将起作用。

相反，混合 nrows 和 ncols 将不与 constrained_layout 一起使用：plt.subplot(2, 2, 1) 后面跟着 plt.subplots(2, 1, 2) 仍然会生成两个 GridSpecs，并且 constrained_layout=True 将导致不好的结果。为了达到预期的效果，第二次调用可以指定第二个 Axes 应该覆盖的单元格：plt.subplots(2, 2, (2, 4))，或者更 Pythonic 的 plt.subplot2grid((2, 2), (0, 1), rowspan=2) 也可以使用。

绘图方法 #

`axline` 支持 transform 参数 #

axline 现在支持 transform 参数，它应用于点 xy1, xy2。slope（如果给定）始终在数据坐标中。

例如，这可以与 ax.transAxes 一起使用，用于绘制具有固定斜率的线。在下面的图中，即使它们显示不同的数据限制，该线也会穿过两个 Axes 上的相同点。

fig, axs = plt.subplots(1, 2)

for i, ax in enumerate(axs):
    ax.axline((0.25, 0), slope=2, transform=ax.transAxes)
    ax.set(xlim=(i, i+5), ylim=(i, i+5))

可以将一系列填充样式指定给 bar 和 barh#

可以将一系列填充样式指定给 `bar` 和 `barh`#