在Python中，legend是matplotlib库中用于标识图表元素的图例，正确设置legend能大幅提升图表可读性，本文将从基础用法到高级定制，一次性讲透legend python的所有核心操作。
legend python 基础用法：从入门到实战
如何快速添加图例
添加图例只需要两步：在绘图时指定label参数，随后调用legend()，我们绘制一条折线图：
import matplotlib.pyplot as plt plt.plot([1,2,3], [4,5,6], label='数据系列') plt.legend()
如果多个数据系列,每个plot都带上label，然后一句legend()就能自动收集所有标签，很多新手问python legend 图例怎么设置，其实这套流程就是最标准的做法，如果你没有在绘图时指定label，也可以在legend()中传入字符串列表，但顺序必须和绘图元素一致，容易出错，不推荐。
图例的默认位置与自动调整
matplotlib默认选择“最佳”位置（loc=’best’），它会尽量避开数据点，但自动判断不一定完美，尤其当数据密集时，行业共识认为，手动指定位置比依赖自动更可靠，常见的loc参数包括：’upper right’、’lower left’、’center’等，如果你希望图例固定在右上角，直接写loc='upper right'即可。
图例字体与框体样式
通过prop参数可以精细控制字体属性,例如plt.legend(prop={'size': 12, 'family': 'serif'})，frameon控制是否显示边框，我通常会在简洁风格的图表中关闭边框：frameon=False，边框颜色和透明度也有对应参数，后续样式定制部分会详细展开。
legend python 位置设置：让图例不遮挡数据
图例位置参数详解
loc参数是字符串或数字,对应一系列锚点位置，更灵活的是bbox_to_anchor，它允许你指定图例的锚点坐标（基于坐标轴归一化，0到1），将图例放在图表右上角外部：
plt.legend(bbox_to_anchor=(1.05, 1), loc='upper left')
这里loc=’upper left’表示图例的左上角对准(1.05, 1)，注意，坐标超过1就表示在图表外侧，理解这个组合是定位图例的关键。
场景：折线图与柱状图的图例放置技巧
- 折线图：数据点通常位于中间区域，图例放在右上角或右下角一般不会遮挡，如果线条较多，可以放在图外右侧，利用空白区域。
- 柱状图：柱体占据横向空间，图例放在图外上方或右侧更安全，在数据报告场景中，柱状图经常需要并排对比，图例必须清晰且不干扰柱体，操作路径：
plt.legend(bbox_to_anchor=(1.02, 1), loc='upper left')，然后配合plt.subplots_adjust(right=0.78)给图例留出空间。
图例超出画布的处理方法
当图例放在外部时,经常被裁剪，有三种常用修复方式：
- 使用
plt.tight_layout()自动调整，但有时效果不稳定。 - 创建图表时设置
constrained_layout=True，更智能。 - 手动调整留白：
plt.subplots_adjust(right=0.75)，将右侧区域让给图例，哪种方法最好？取决于具体图表，我一般先用tight_layout，如果不行就手动调整。
legend python 样式定制：打造专业级图例
修改图例标签字体
通过fontsize参数直接调整大小：plt.legend(fontsize=14)，如果需要更精细，可以用prop字典，例如加粗和字族：prop={'weight': 'bold', 'family': 'Arial'}，注意，字体设置在中文环境下可能需要指定支持中文的字体，否则会显示方框。
与边框
能提升信息层级,例如plt.legend(title='变量类型')字体大小通过title_fontsize控制，边框颜色和宽度用edgecolor和linewidth，一个实用技巧：将边框颜色设置为与图表背景融合，避免视觉杂乱。
图例背景与阴影
facecolor设置背景色,常用浅灰色或白色，shadow参数添加阴影，适合用于报告封面或演示场景，但会轻微增加渲染负担，在学术图中，通常关闭阴影以求简洁。
图例透明度与圆角
alpha控制图例整体透明度,值为0到1，fancybox=True可以让框体变为圆角，视觉效果更柔和。
plt.legend(facecolor='lightgray', edgecolor='gray', alpha=0.8, fancybox=True)
这套组合能让图例更精致,但不要过度使用，保持一致性更重要。
legend python 高级技巧：多图例与手动创建
一个图中添加多个图例
默认一个axes只能有一个legend,但要添加第二个图例，可以通过add_artist()，操作步骤：先创建第一个图例，然后创建第二个图例对象，再用ax.add_artist(legend2)，注意，第二个图例需要手动指定handles和labels。
legend1 = ax.legend(handles1, labels1, loc='upper right') legend2 = ax.legend(handles2, labels2, loc='lower left') ax.add_artist(legend2)
这样就能在同一张图上展示两组图例,适用于对比不同数据分类。
手动创建图例元素
当图例需要展示不直接对应绘图元素的内容时,可以手动创建图例对象，使用matplotlib.patches中的Patch，或lines中的Line2D，创建一个红色矩形代表“训练集”，一个蓝色圆形代表“验证集”：
from matplotlib.patches import Patch handles = [Patch(color='red', label='训练集'), Patch(color='blue', label='验证集')] plt.legend(handles=handles, loc='upper right')
这在制作自定义图例时非常灵活,尤其在机器学习可视化中常用。
图例与图表的交互应用
在Jupyter Notebook中使用%matplotlib notebook时，图例更新需要重新绘制整个图表，对于动态数据，建议使用plotly或bokeh，它们原生支持交互式图例，点击即可隐藏/显示数据系列，但matplotlib的图例在静态图中依然是最主流的选择。
legend python 常见问题与解决方案
图例没有显示
最常见的原因是忘记调用legend()，或者绘图元素没有设置label，检查每一个plot、scatter、bar等函数是否都带有label参数，如果使用pandas的plot方法，默认可能不包含label，需要显式指定：
df.plot(label='数据')，业内专家指出，至少80%的图例缺失问题都是因为label未设置。
图例重复
在循环中多次调用plot并设置相同label,导致图例出现重复项，解决方法：在循环中只调用一次legend()，或者使用以下代码去重：
handles, labels = ax.get_legend_handles_labels() by_label = dict(zip(labels, handles)) ax.legend(by_label.values(), by_label.keys())
这段代码通过字典自动去重,保留最后出现的handle。
图例位置与预期不符
使用bbox_to_anchor时,位置偏移往往是因为对锚点逻辑理解有误，bbox_to_anchor定义的是图例锚点所在坐标，loc定义的是图例的哪个锚点在此坐标，loc=’upper left’意味着图例的左上角放在bbox位置，如果希望图例在图表右上角外侧，应设置bbox_to_anchor=(1.02, 0.98), loc='upper left'，而不是loc='upper right'，这个小细节经常让人困惑。
legend python 疑问解答
如何在legend python 中设置图例的透明度？
通过alpha参数控制整体透明度,例如plt.legend(alpha=0.6)，如果只想改变边框透明度，使用framealpha参数，注意，alpha会影响背景和文字，framealpha只影响边框和背景框。
legend python 图例字体大小如何调整？
使用fontsize参数：plt.legend(fontsize=12)，如果需要更精细控制，用prop字典：plt.legend(prop={'size': 12, 'weight': 'bold'})，在中文场景下，建议同时设置字体族，否则中文可能显示为方框。
legend python 中如何让图例显示在图表外部？
使用bbox_to_anchor参数将图例锚点移到图表范围外,将图例放在右侧外部：plt.legend(bbox_to_anchor=(1.05, 1), loc='upper left')，然后配合plt.subplots_adjust(right=0.75)调整图表区域，避免图例被裁剪，如果使用tight_layout，需要设置rect参数预留空间。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/legend-python%e6%98%af%e4%bb%80%e4%b9%88%ef%bc%8c%e6%80%8e%e4%b9%88%e7%94%a8/
