如何解决FigureCanvasTkAgg组件中图例、标注超出显示范围的问题？

核心思路是利用Matplotlib的自动布局能力，将图例、长标签等动态元素纳入布局计算范围，无需硬编码画布尺寸即可避免内容溢出，可行方案如下：

• 开启约束布局：创建Figure时启用constrained_layout参数，Matplotlib会自动计算所有可见元素的尺寸，动态调整子图边距，保证图例、标签都在画布显示范围内。
• 手动传入额外元素到布局计算：如果使用tight_layout手动调整布局，需要将图例对象作为bbox_extra_artists参数传入，让布局逻辑把图例的尺寸纳入计算。
• 超长标签自动换行：针对长度不可控的标签，添加简单的自动换行逻辑，避免单个标签横向过长导致溢出。
• 动态调整饼图占比：可根据标签平均长度动态调整饼图的radius参数，给外侧标签预留足够显示空间。

修改后可运行代码 #

import tkinter as tk
import matplotlib.pyplot as plt
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg

# 超长标签自动换行辅助函数
def wrap_long_label(text, max_line_length=15):
    return '\n'.join([text[i:i+max_line_length] for i in range(0, len(text), max_line_length)])

# GUI代码
window = tk.Tk()
window.title("Test App")

canvas = tk.Canvas(window, width=1200, height=600)
canvas.grid(columnspan=2, rowspan=4)

# 创建Figure时开启约束布局，自动适配所有元素
figure, axes = plt.subplots(constrained_layout=True)

labels = ["Cat", "Dog", "Leopardddddddddddddddddddddddddddddddddddddddddddddddddddddddd"]
# 标签自动换行处理
wrapped_labels = [wrap_long_label(l) for l in labels]

axes.pie([2,3,6], labels=wrapped_labels, normalize=True, labeldistance=1.1)
# 图例放在坐标轴外侧右上角，约束布局会自动预留对应空间
leg = axes.legend(labels, bbox_to_anchor=(1, 1), fontsize=8)

figCanvas = FigureCanvasTkAgg(figure, master=window)
figCanvas.draw()
figCanvas.get_tk_widget().grid(row=1, column=1, padx=10)

window.mainloop()

补充说明 #

如果不想使用约束布局，也可以用tight_layout手动适配，替换创建Figure和布局的代码即可：

# 关闭约束布局时的适配方式
figure, axes = plt.subplots()
# ... 其余绘图代码不变
# 手动调用tight_layout，传入图例对象参与布局计算
figure.tight_layout(bbox_extra_artists=(leg,))

两种方案都无需硬编码figsize、dpi等固定参数，可适配每次启动时动态变化的标签、图例尺寸。

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