如何在Matplotlib多子图布局中实现子图间的箭头连线绘制

原有代码失效的核心原因 #

你之前单轴场景下可用的plt.arrow()方法，本质是在当前激活子轴（Axes）的内部数据坐标系下绘制元素，跨子图场景下完全不适用：

• 各子图的坐标范围完全独立，传入的坐标值只会被解析为当前激活子图的内部坐标，无法定位到另外一个子图上的目标位置
• 箭头元素会被绑定在当前子图的图层体系下，后续调整子图间距、位置时，箭头不会和目标点位联动，容易出现错位、被遮挡的问题

可实现的跨子图箭头方案 #

方案1：基于Figure归一化坐标的联动箭头（推荐） #

这是适配性最强的方案，能实现箭头跟随子图内目标点位自动联动，不会因为布局调整错位。
实现逻辑：

• 编写工具函数，把子图内任意数据坐标，转换成整个画布（Figure）的归一化坐标（画布左下角为(0,0)，右上角为(1,1)）
• 使用FancyArrowPatch绘制箭头，将箭头的坐标转换规则绑定到Figure坐标系下，而非单个子图的坐标系

参考实现代码：

import matplotlib.pyplot as plt
from matplotlib.patches import FancyArrowPatch

# 1行3列的子图布局
fig, (ax_left, ax_mid, ax_right) = plt.subplots(1, 3, figsize=(12, 4))

# 坐标转换工具：把子图内的(x,y)数据坐标转成Figure归一化坐标
def trans_to_fig_coord(ax, x, y):
    # 子图数据坐标 → 画布像素坐标
    pixel_pos = ax.transData.transform((x, y))
    # 画布像素坐标 → Figure归一化坐标
    return fig.transFigure.inverted().transform(pixel_pos)

# 示例：连接左侧子图的(0.3, 0.6) 和 中间子图的(0.7, 0.6)
start_pos = trans_to_fig_coord(ax_left, 0.3, 0.6)
end_pos = trans_to_fig_coord(ax_mid, 0.7, 0.6)

# 生成跨子图箭头
cross_arrow = FancyArrowPatch(
    start_pos, end_pos,
    arrowstyle='->',
    mutation_scale=12, # 控制箭头头部大小
    linewidth=0.75,
    color='black',
    transform=fig.transFigure # 关键：绑定到Figure坐标系，而非单个子图
)
# 把箭头添加到Figure图层
fig.patches.append(cross_arrow)

这种绘制方式的优势：哪怕后续调整子图边距、修改子图内的数据范围，箭头始终会对准指定的两个数据点位，不会出现偏移。

方案2：固定位置的示意性跨图箭头 #

如果箭头不需要绑定具体数据点，只是在两个子图之间做固定位置的布局示意，可以直接用硬编码的Figure坐标绘制，省去坐标转换步骤：

# 直接在Figure归一化坐标下画箭头，起点x=0.3, y=0.5，向右延伸0.15长度
fixed_arrow = plt.Arrow(
    x=0.3, y=0.5,
    dx=0.15, dy=0,
    width=0.006,
    color='black',
    transform=fig.transFigure
)
fig.add_artist(fixed_arrow)

注意：这种方式的箭头位置是固定写死的，不会随子图位置、子图内的数据变化联动，仅适合做静态布局层面的连线示意。

常见踩坑提醒 #

• 不要直接用原有的plt.arrow()方法跨子图绘图：该方法默认将元素绑定到当前激活的子轴上，传入的跨子图坐标会被错误解析为当前轴的内部坐标，要么画在当前轴范围内，要么直接溢出画布
• 不要把箭头元素绑定到单个子图的图层：否则当子图被其他图形元素遮挡时，箭头也会被一并遮挡，不符合跨图连线的视觉效果
• 如果需要箭头和数据点位联动，务必通过坐标转换拿到Figure级别的位置，不要硬编码归一化坐标值，否则很容易因为布局调整出现错位

内容的提问来源于stack exchange，提问作者user13680518