为何Ttk复选框调用函数无法修改Matplotlib Pyplot图表标题？

核心原因 #

你遇到的问题本质是Tkinter事件循环和Matplotlib绘图上下文的刷新不同步：通过复选框触发回调函数时，虽然标题变量已更新、控制台输出也能证明函数执行了，但Matplotlib不会自动感知Tkinter事件里的绘图修改，必须手动触发画布刷新，否则旧标题会一直停留在界面上。

具体解决步骤 #

1. 复用绘图对象：确保fig和ax是全局可访问的对象，不要在每次调用change_title时重新创建新的绘图实例。
2. 手动刷新画布：修改标题后，调用fig.canvas.draw()（面向对象API）或plt.draw()（pyplot API）强制Matplotlib更新界面。
3. 确认后端设置：Tkinter和Matplotlib集成时，必须提前设置正确的后端：

import matplotlib
matplotlib.use('TkAgg')  # 必须放在import matplotlib.pyplot之前
import matplotlib.pyplot as plt

修正后的示例代码 #

import tkinter as tk
from tkinter import ttk
import matplotlib
matplotlib.use('TkAgg')
import matplotlib.pyplot as plt

# 全局计数和绘图对象
title_count = 1
fig, ax = plt.subplots()
ax.set_title(f'Title number {title_count}')
plt.show(block=False)  # 非阻塞显示，避免卡住Tkinter事件循环

def change_title():
    global title_count
    title_count += 1
    new_title = f'Title number {title_count}'
    ax.set_title(new_title)
    print(f'Title changed to {title_count}')
    # 关键：手动刷新画布
    fig.canvas.draw()

# 创建Tkinter窗口
root = tk.Tk()
check_btn = ttk.Checkbutton(root, text='切换标题', command=change_title)
check_btn.pack(pady=10)

root.mainloop()

为什么直接调用函数正常？ #

直接调用change_title时，代码在Matplotlib的事件循环上下文里执行，修改后会自动触发刷新；但通过Tkinter复选框回调时，执行上下文切换到了Tkinter的事件循环，Matplotlib无法自动捕获修改，必须手动刷新。

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