Seaborn catplot图例异常：自动添加与重复问题排查

问题现象 #

两段Seaborn catplot代码逻辑相似，但图例表现完全相反：

1. 第一段代码（x与hue绑定同一字段）：必须手动调用ax.add_legend()才会显示图例，不调用则无图例

ax = sns.catplot(x='region', hue='region', y='Počet',col='Viditeľnosť', data=vis, kind='bar', palette='hls',col_wrap=2,sharex=False, dodge=False)

for axis in ax.axes:
    axis.bar_label(axis.containers[0])
    axis.bar_label(axis.containers[1])
    axis.bar_label(axis.containers[2])
    axis.bar_label(axis.containers[3])
    axis.set_xlabel('Kraj')

ax.fig.tight_layout()
ax.add_legend()

2. 第二段代码（x与hue为不同字段）：未调用ax.add_legend()时已自动生成图例，调用后出现重复图例

ax = sns.catplot(x='month', hue='Druh srážky', y='Počet',col='region', data=dir, kind='bar', palette='hls',col_wrap=2,sharex=False)
ax.set_titles(col_template="Kraj: {col_name}")
ax.fig.tight_layout()
ax.add_legend()

原因分析 #

• 第一段代码：x轴字段region与hue分组字段完全相同，且设置了dodge=False（柱子不偏移）。Seaborn会判定x轴标签已经可以明确区分每个颜色对应的分组，无需额外图例，因此默认不生成图例，必须手动调用add_legend()才会显示。
• 第二段代码：x轴字段month与hue分组字段Druh srážky是不同维度，每个x类别下存在多个hue分组，Seaborn会自动生成图例来区分不同的hue类别，此时再调用add_legend()会重复添加一个图例。

修复方案 #

1. 针对第一段代码：
   • 如果需要保留图例：继续保留ax.add_legend()调用即可；
   • 如果不需要图例：直接删除ax.add_legend()，因为x轴标签已经能对应颜色分组，图例属于冗余信息。
2. 针对第二段代码：
   • 直接删除ax.add_legend()这一行，保留Seaborn自动生成的默认图例；
   • 如果需要调整图例的位置、标题等样式，可以使用ax.legend(title="自定义标题", loc="upper right")来修改，而非重复添加图例。

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