如何解决Matplotlib中指向同一点的两个箭头头部存在间隙的问题

问题复现 #

在使用Matplotlib的annotate绘制双向箭头时，即使设置了shrinkA=0、shrinkB=0，分别从两侧指向同一点的两个箭头尖端仍然会存在1像素的间隙，关闭网格时该现象尤其明显。
可复现示例代码如下：

import matplotlib.pyplot as plt

fig = plt.figure()
ax = fig.add_subplot()
ax.plot([0],[0])
# ax.grid()
ax.set_xlim([0,10])
ax.set_ylim([0,10])
# 第一个箭头从x=2指向x=4，y=1
ax.annotate("", (2, 1), (4, 1), arrowprops={'arrowstyle':'<->', 'shrinkA': 0, 'shrinkB': 0})
# 第二个箭头从x=4指向x=6，y=1
ax.annotate("", (4, 1), (6, 1), arrowprops={'arrowstyle':'<->', 'shrinkA': 0, 'shrinkB': 0})
plt.show()

这个问题的核心是Matplotlib默认渲染箭头时，箭头尖端的坐标不会完全对齐到指定的端点，且shrink*参数不支持负值延伸，无法直接通过该配置消除间隙。

可用解决方案 #

方案1：修改箭头渲染配置，让长度包含箭头头部 #

在arrowprops中添加length_includes_head=True参数，强制箭头总长度计算包含箭头头部，让尖端精准对齐到指定端点：

ax.annotate("", (2, 1), (4, 1), arrowprops={
    'arrowstyle':'<->', 
    'shrinkA': 0, 
    'shrinkB': 0,
    'length_includes_head': True
})
ax.annotate("", (4, 1), (6, 1), arrowprops={
    'arrowstyle':'<->', 
    'shrinkA': 0, 
    'shrinkB': 0,
    'length_includes_head': True
})

该方案不需要修改坐标，适配性最高，不同缩放比例、dpi下都能正常对齐。

方案2：微调配点坐标补全间隙 #

如果方案1不生效（部分旧版本Matplotlib存在兼容问题），可以根据坐标轴范围微调对接点的坐标，抵消渲染偏移：

# 计算1像素对应的x轴坐标偏移量
x_range = ax.get_xlim()[1] - ax.get_xlim()[0]
pixel_offset = x_range * 0.7 / fig.dpi

# 第一个箭头右端点向右偏移1像素，第二个箭头左端点向左偏移1像素
ax.annotate("", (2, 1), (4 + pixel_offset, 1), arrowprops={'arrowstyle':'<->', 'shrinkA': 0, 'shrinkB': 0})
ax.annotate("", (4 - pixel_offset, 1), (6, 1), arrowprops={'arrowstyle':'<->', 'shrinkA': 0, 'shrinkB': 0})

该方案可以精准补全1像素间隙，且适配不同dpi的画布。

方案3：使用FancyArrowPatch自定义箭头 #

如果需要更灵活的箭头控制，可以直接用FancyArrowPatch创建箭头，手动指定端点对齐规则：

from matplotlib.patches import FancyArrowPatch

arrow1 = FancyArrowPatch((2,1), (4,1), arrowstyle='<->', shrinkA=0, shrinkB=0, 
                        capstyle='butt', joinstyle='miter', length_includes_head=True)
arrow2 = FancyArrowPatch((4,1), (6,1), arrowstyle='<->', shrinkA=0, shrinkB=0, 
                        capstyle='butt', joinstyle='miter', length_includes_head=True)
ax.add_patch(arrow1)
ax.add_patch(arrow2)

该方案可以完全自定义箭头的渲染规则，适用于复杂的箭头绘制场景。

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