Matplotlib 3.11.0 新功能（2026年6月11日）#

有关自上次修订以来的所有问题和拉取请求列表，请参阅 GitHub 3.11.0 版本统计信息 (2026年6月11日)。

图形创建/管理 #

图形可以附加到 pyplot 或从其移除 #

图形现在可以通过 pyplot 附加和移除，这意味着后台与后端的耦合度降低。

特别地，独立图形（使用 Figure 构造函数创建）现在可以通过调用 plt.figure(fig) 注册到 pyplot 模块中。这允许你像处理通过 plt.figure() 或 plt.subplots() 等 pyplot 工厂函数创建的任何图形一样，使用 plt.show() 来展示它们。

当关闭已显示的图形窗口时，相关图形将重置为独立状态，即 pyplot 不再可见。但如果你仍持有对它的引用，则可以继续操作它（例如执行 fig.savefig()，或者通过 plt.figure(fig) 将其重新添加到 pyplot 并再次显示）。

现在可以实现以下操作——尽管该示例为了展示可能性而稍显夸张。在实际操作中，为了更好的连贯性，建议使用更简单的形式。

import matplotlib.pyplot as plt
from matplotlib.figure import Figure

# Create a standalone figure
fig = Figure()
ax = fig.add_subplot()
ax.plot([1, 2, 3], [4, 5, 6])

# Register it with pyplot
plt.figure(fig)

# Modify the figure through pyplot
plt.xlabel("x label")

# Show the figure
plt.show()

# Close the figure window through the GUI

# Continue to work on the figure
fig.savefig("my_figure.png")
ax.set_ylabel("y label")

# Re-register the figure and show it again
plt.figure(fig)
plt.show()

图形尺寸单位 #

创建图形时，现在可以定义以厘米或像素为单位的图形大小。

在此之前，图形大小通过 plt.figure(..., figsize=(6, 4)) 指定，且给定的数字被解释为英寸。现在可以向元组添加单位字符串，例如 plt.figure(..., figsize=(600, 400, "px"))。支持的单位字符串包括 "in", "cm", 或 "px"。

创建图形时部分 `figsize` 规范 #

图形创建现在接受 figsize 中的单个 None。传入 (None, h) 使用 rcParams["figure.figsize"]（默认：[6.4, 4.8]）中的默认宽度；传入 (w, None) 使用默认高度。传入 (None, None) 是无效的，会引发 ValueError。

例如：

plt.rcParams['figure.figsize'] = (14, 11)
fig = plt.figure(figsize=(None, 4))  # Size will be (14, 4)

`Figure.clear` 中重置子图参数 #

调用 Figure.clear() 时，gridspec.SubplotParams 的设置将恢复为默认值。

SubplotParams.to_dict 是一个获取子图参数字典的新方法，SubplotParams.reset 可将参数重置为默认值。

注释 #

`bar_label` 支持为每个标签设置单独的内边距 #

bar_label 现在接受浮点值或类数组对象作为内边距。类数组对象定义了每个标签各自的内边距。

`BoxStyle` 的箭头样式子类支持调整箭头头部大小 #

新增的 head_width 和 head_angle 参数允许调整 BoxStyle.LArrow, BoxStyle.RArrow 和 BoxStyle.DArrow 所用箭头头部的大小和宽高比。

为了在所有参数值下保持一致的外观，默认的头部位置（相对于文本的起始位置）与之前的硬编码位置相比略有更改。

通过使用负角度（或对应的反角度）作为 head_angle，可以创建“反向”头部的箭头。

plt.text(0.2, 0.8, "LArrow", ha='center', size=16,
         bbox=dict(boxstyle="larrow, pad=0.3, head_angle=150"))
plt.text(0.2, 0.2, "LArrow", ha='center', size=16,
         bbox=dict(boxstyle="larrow, pad=0.3, head_width=0.5"))
plt.text(0.5, 0.8, "DArrow", ha='center', size=16,
         bbox=dict(boxstyle="darrow, pad=0.3, head_width=3"))
plt.text(0.5, 0.2, "DArrow", ha='center', size=16,
         bbox=dict(boxstyle="darrow, pad=0.3, head_width=1, head_angle=60"))
plt.text(0.8, 0.8, "RArrow", ha='center', size=16,
         bbox=dict(boxstyle="rarrow, pad=0.3, head_angle=30"))
plt.text(0.8, 0.2, "RArrow", ha='center', size=16,
         bbox=dict(boxstyle="rarrow, pad=0.3, head_width=2, head_angle=-90"))
plt.axis("off")