Matplotlib的legend()默认不支持自动折行，因图例容器宽度由文本渲染后静态计算且无wrap=True参数；需用textwrap.fill()预处理标签字符串并配合bbox_to_anchor、tight_layout及字体设置综合调控。
legend 自动折行为什么默认不生效
Matplotlib 的 legend() 默认不会对长图例文本做自动换行，即使设置了 ncol 或调整了 bbox_to_anchor，文本仍可能被截断或撑出画布。根本原因是：图例容器（Legend 对象）的宽度由内部文本渲染后一次性计算，不支持按字符/像素动态折行；且 wrap=True 这类参数在 legend() 中并不存在。
用 textwrap.fill() 预处理 label 文本
最直接可控的方式是手动把长 label 拆成多行字符串，再传给 plt.legend()。关键点在于：必须在调用 legend() 前完成换行，且换行逻辑要适配图例区域宽度（通常靠经验或试错定字符数）。
- 使用
import textwrap，对每个 label 调用textwrap.fill(label, width=15)（width是每行最大字符数，需根据字体大小和图例宽度调整） - 避免直接对中文混排 label 用固定
width，建议先用等宽字体测试，或改用textwrap.shorten()+ 换行组合 - 若 label 来自变量名或路径，优先截断非关键部分（如用
os.path.basename()替代全路径）
import matplotlib.pyplot as plt import textwrap labels = ["Very long experimental condition name with many parameters", "Short label"] wrapped_labels = [textwrap.fill(l, width=20) for l in labels] plt.plot([1,2], label=wrapped_labels[0]) plt.plot([2,3], label=wrapped_labels[1]) plt.legend()
配合 bbox_to_anchor 和 loc 控制图例位置边界
即使文本已折行，图例框仍可能因默认 loc='best' 计算不准而溢出。必须显式限定图例锚点和尺寸约束：
- 用
bbox_to_anchor=(x, y, width, height)四元组（需配合loc='center'），其中width和height是归一化坐标系下的相对尺寸，可防止图例横向撑开 - 更稳妥的是用
plt.tight_layout(rect=[0, 0, 0.85, 1])留出右侧空间，再将图例放在图外：plt.legend(bbox_to_anchor=(1.02, 1), loc='upper left') - 注意
plt.tight_layout()必须在plt.legend()之后调用，否则图例不参与布局计算
font size 和 line spacing 对折行效果的实际影响
图例是否“看起来没折行”或“行距太挤”，往往不是逻辑问题，而是渲染细节没调好：
-
plt.legend(fontsize='small')或fontsize=8能显著增加单行容纳字符数，减少折行必要性 - 行高无法直接设，但可通过
plt.rcParams['legend.handletextpad'] = 0.4和'legend.labelspacing' = 0.8微调文字与符号、行与行之间的距离 - 中文字体需提前设置，否则
textwrap按 ASCII 字符计数会失效（一个中文字符占 2 个位置），推荐用fontproperties指定matplotlib.font_manager.FontProperties(fname=...)
真正难的是平衡：折行太少 → 文字溢出；折行太多 → 图例高度爆炸、遮挡曲线；字体太小 → 难以阅读。这些没有银弹，得结合输出尺寸（figsize）、DPI、目标载体（屏幕/PDF）反复微调。
