Python中使用seaborn绘制无柱直方图时图例不显示问题

问题原因 #

你传入histplot的label参数默认绑定到直方图的柱形元素上，当你移除/隐藏柱形后，带标签的可见元素从轴对象中消失，ax.get_legend_handles_labels()无法抓取到有效手柄，因此触发No handles with labels found to put in legend.报错。

解决方法 #

有三种常用的可行方案，按需选择即可：

• 方案1：通过kde_kws直接给KDE线设置标签
  该方案最简便，标签直接绑定到KDE线元素上，不受柱形移除的影响：

fig, ax = plt.subplots()
sns.histplot(
    data, 
    kde=True, 
    binwidth=5,  
    stat="probability", 
    kde_kws={'cut': 3, 'label': 'data1'}
)
# 你原本移除柱形的代码保留即可，比如：
for patch in ax.patches:
    patch.remove()
ax.legend(loc='best')

• 方案2：手动给生成的KDE线设置标签
  histplot生成的KDE线存放在ax.lines列表中，直接给对应线元素设置标签即可：

fig, ax = plt.subplots()
sns.histplot(data, kde=True, binwidth=5, stat="probability", kde_kws={'cut': 3})
# 给第一个KDE线设置标签
ax.lines[0].set_label('data1')
# 移除柱形
for patch in ax.patches:
    patch.set_visible(False)
ax.legend(loc='best')

• 方案3：手动构造图例手柄
  如果有多条KDE线需要自定义样式，可手动构造图例手柄：

from matplotlib.lines import Line2D
fig, ax = plt.subplots()
sns.histplot(data, kde=True, binwidth=5, stat="probability", kde_kws={'cut': 3})
# 移除柱形
for patch in ax.patches:
    patch.remove()
# 手动构造对应样式的手柄
custom_handle = Line2D([], [], color=ax.lines[0].get_color(), label='data1')
ax.legend(handles=[custom_handle], loc='best')

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