Matplotlib图例外置自动调整技巧

Matplotlib 图例外置看似只需设置 `bbox_to_anchor` 和 `loc` 两个参数，实则涉及坐标系理解、自动布局协同与视觉细节把控的完整链条：`bbox_to_anchor` 定义图例相对于整个 figure 的锚点位置（如 `(1.02, 1)` 表示右上角外侧），`loc` 决定图例自身哪一点与该锚点对齐（错配会导致图例被截断或“飘移”）；而真正让图例完整可见的关键一步是 `tight_layout(rect=...)`——它强制为图例预留空间，否则默认布局会无视图外元素造成遮挡或裁剪；再加上字体大小、边框样式、多子图共享图例等实战细节，才能实现专业、整洁、响应式强的图表呈现。

用 plt.legend() 的 bbox_to_anchor 和 loc 控制图例位置

图例放图外的核心是脱离坐标轴范围，靠 bbox_to_anchor 指定锚点坐标（相对于整个 figure），再用 loc 定义图例自身哪一点对齐该锚点。比如右上角外侧：plt.legend(bbox_to_anchor=(1.02, 1), loc='upper left')。注意坐标系：x ∈ [0,1] 是 figure 宽度比例，x > 1 就在图右侧；y > 1 就在图上方。

常见错误是只设 bbox_to_anchor 却忽略 loc，导致图例“飘”得离谱——例如 (1.02, 1) 配 loc='center'，图例中心会卡在右上角边缘，一半被切掉。

• loc='upper right' + bbox_to_anchor=(1.02, 1)：图例右上角贴图右边界
• loc='lower left' + bbox_to_anchor=(0, -0.15)：图例左下角放在图正下方
• 横向图例放底部时，推荐 ncol 控制列数，避免过长换行错乱

必须调用 plt.tight_layout() 或 fig.tight_layout()

光设图例位置不够，matplotlib 默认布局不会为图外元素留白，图例大概率被截断或压盖坐标轴。解决方法不是手动调 plt.subplots_adjust() 猜参数，而是用 tight_layout() 自动重排。

但要注意：如果图例在右侧，tight_layout() 默认不考虑它，需显式传参：plt.tight_layout(rect=[0, 0, 0.85, 1])，意思是“把绘图区压缩到 figure 宽度的 85%，右边 15% 给图例”。数值要根据图例宽度微调，0.85 是常见起点。

• 图例在右侧 → rect=[0, 0, 0.85, 1]
• 图例在下方 → rect=[0, 0.1, 1, 1]（下边留 10%）
• 用 fig.tight_layout() 更灵活，可配合 pad、h_pad 微调间距

避免 plt.legend() 覆盖已有图形或文字

图例放图外后仍可能和标题、子图标签冲突，尤其多子图时。这时不能只依赖 tight_layout()，得检查 plt.suptitle() 或 ax.set_title() 是否被挤偏。一个可靠做法是：先画图、加标题、再调 legend()，最后统一 tight_layout()。

另一个坑是使用 plt.figure(figsize=...) 时，figure 太小会导致图例文字挤压变形——图例字体大小默认不随 figure 缩放，建议显式设 fontsize 或用 prop={'size': 10}。

• 图例文字太小？加 fontsize=10 或 prop={'size': 10}
• 图例边框太粗？加 frameon=True, fancybox=False, shadow=False 控制样式
• 多子图共享图例时，别在每个 ax 上重复 legend()，统一用 fig.legend()

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Matplotlib图例外置自动调整技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。