如何修正循环绘制柱状图时的标注重叠问题

问题分析 #

堆叠柱状图绘制正常，但标注出现重叠，核心问题在于遍历labels[l].items()和other_bars时，labels[l]包含大量NaN值，直接zip会导致有效标注和柱状图rect的对应关系混乱，同时未正确处理同一月份多个标注的垂直间距。

修复方案 #

1. 先筛选出labels[l]中非NaN的条目，同时获取对应的索引位置，确保匹配到正确的柱状图rect
2. 优化同一月份多标注的垂直偏移计算，避免重叠

修正后的循环代码 #

替换原代码中标记为# THIS LOOP MUST BE CORRECTED的循环部分：

# 先筛选当前列需要标注的月份和值，保留索引
valid_labels = labels[l].dropna().items()
# 获取每个需要标注的月份对应的rect索引
valid_indices = [df7_2_bars.index.get_loc(month) for month, _ in valid_labels]
# 重新获取有效标签对（避免上面的迭代消耗）
valid_labels = labels[l].dropna().items()

for (month, value), idx in zip(valid_labels, valid_indices):
    rect = other_bars[idx]
    center_x, _ = rect.get_center()
    existing_label = bar_labels.get(month)

    if existing_label:
        # 获取已有标签的顶部位置（转换为数据坐标）
        label_bbox = existing_label.get_window_extent()
        label_top = bar_ax.transData.inverted().transform((0, label_bbox.top))[1]
    else:
        label_top = 0

    # 计算当前标注的基础位置，加上偏移避免重叠
    bar_base_y = rect.get_y() + rect.get_height()
    bar_y = bar_base_y if bar_base_y > label_top else label_top + 5  # 固定间距5
    bar_labels[month] = bar_ax.annotate(
        f'{value:.0f}',
        (center_x, bar_y),
        textcoords='offset points',
        xytext=(0, 2),
        ha='center',
        color=rect.get_facecolor(),
        path_effects=[Stroke(linewidth=0, foreground='gainsboro'), Normal()]
    )

关键优化点 #

• 先筛选有效标注，避免遍历NaN值，确保每个标注都对应正确的柱状图块
• 调整同一月份多标注的垂直间距，用固定偏移量替代max，保证标注之间有足够空隙
• 通过索引匹配rect，避免zip因NaN导致的错位

参考指南要点 #

• Matplotlib Annotate：使用get_window_extent()获取文本边界框，通过坐标转换在数据空间和显示空间之间切换，精准控制标注位置
• Pandas 数据筛选：使用dropna()快速过滤缺失值，index.get_loc()获取元素在索引中的位置，实现数据和图形元素的精准对应
• 堆叠柱状图标注：处理多组标注时，需跟踪同一X轴位置的已有标注高度，动态调整新标注的Y轴坐标

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