本文介绍如何在 Matplotlib 堆叠水平条形图中自动隐藏宽度为零对应的标签（如“0”），避免视觉干扰，提升图表专业性与可读性。核心方法是通过 bar_label 返回的 Annotation 对象动态清空零值文本。
本文介绍如何在 matplotlib 堆叠水平条形图中自动隐藏宽度为零对应的标签（如“0”），避免视觉干扰，提升图表专业性与可读性。核心方法是通过 `bar_label` 返回的 `annotation` 对象动态清空零值文本。
在使用 ax.barh() 构建堆叠条形图（尤其是表示技术人员处理不同类别工单的分布场景）时，由于各类别数据稀疏（部分技术人员未收到某类工单），常出现某些条形段宽度为 0。此时若调用 ax.bar_label(..., label_type='center')，Matplotlib 仍会为这些零宽矩形渲染 "0" 标签，导致图中出现多余、误导性的数字（如题图所示），严重影响信息传达。
解决思路并非修改矩形本身（rect.set_width(None) 会报错，因 width 是只读属性），而是精准控制其关联的标签对象。ax.bar_label() 方法返回一个 Annotation 对象列表，每个对应一个条形段中心的文本标签。我们可在生成后遍历该列表，检查 .get_text() 内容，将 "0" 替换为空字符串：
for i, (colname, color) in enumerate(zip(category_names, category_colors)):
widths = data[:, i]
starts = data_cum[:, i] - widths
rects = ax.barh(labels, widths, left=starts, height=0.5,
label=colname, color=color)
# 设置标签颜色（根据背景色自适应）
r, g, b, _ = color
text_color = 'black' if r * g * b < 0.5 else 'darkgrey'
# 生成居中标签并立即过滤零值
all_labels = ax.bar_label(rects, label_type='center', color=text_color)
for lab in all_labels:
if lab.get_text() == '0':
lab.set_text("") # 静默移除，不显示任何字符⚠️ 注意事项：
- 此方法依赖
bar_label的返回值，必须在每次barh调用后立即获取并处理其标签，不可延迟或批量操作； -
lab.set_text("")是安全的，它仅清空文本内容，不影响Annotation的位置或布局； - 若需更精细控制（如仅隐藏特定行的零标签），可结合
rect的get_y()或索引i进行条件判断； - 不建议使用
alpha=0隐藏标签——Annotation对象不支持直接设透明度，且空字符串方案更轻量、语义清晰。
总结而言，与其尝试“删除标签”或“修改矩形”，不如接受 Matplotlib 的设计逻辑：标签是独立于矩形的注解对象。通过 set_text("") 清空内容，既符合 API 规范，又能实现视觉上的“无标签”效果，是处理稀疏堆叠条形图标签问题的简洁、可靠方案。
