如何在Python线程运行期间关闭Matplotlib绘图？

问题根源 #

Matplotlib的GUI交互（包括窗口的打开、关闭、更新）必须在主线程中执行，所有主流GUI框架（Tk、Qt等）都是单线程模型，子线程中直接操作GUI会触发线程安全问题，导致plt.close()指令无法被事件循环处理，最终出现卡顿、窗口无法关闭的情况。

解决方案：线程间通信+主线程处理GUI #

核心思路是：子线程仅负责业务逻辑（比如数据计算、任务执行），通过队列传递"打开/关闭绘图"的指令；主线程专门处理Matplotlib的GUI操作，监听队列并执行对应的指令。

完整代码示例

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

def plot_controller(q):
    # 初始化Tkinter环境（适配Matplotlib的TkAgg后端）
    root = tk.Tk()
    root.withdraw()  # 隐藏默认的Tk主窗口

    # 创建绘图对象
    fig, ax = plt.subplots(figsize=(6, 4))
    ax.plot([1, 3, 2, 4, 5])
    ax.set_title("可手动关闭的线程绘图")

    # 将绘图绑定到Tkinter画布
    canvas = FigureCanvasTkAgg(fig, master=root)
    canvas.draw()
    canvas.get_tk_widget().pack(padx=10, pady=10)

    # 定期检查队列，处理指令
    def check_queue():
        try:
            cmd = q.get_nowait()
            if cmd == "close":
                plt.close(fig)
                root.quit()  # 退出Tk事件循环
        except queue.Empty:
            pass
        root.after(100, check_queue)  # 每100ms检查一次队列

    root.after(100, check_queue)
    root.mainloop()  # 启动Tk事件循环（必须在主线程）

def worker(q):
    print("子线程开始执行任务...")
    # 模拟耗时业务操作
    time.sleep(3)
    # 发送关闭绘图的指令
    q.put("close")
    print("已发送关闭绘图指令")
    # 继续执行后续任务
    time.sleep(2)
    print("子线程任务执行完毕")

if __name__ == "__main__":
    # 创建线程间通信队列
    cmd_queue = queue.Queue()

    # 启动子线程
    worker_thread = threading.Thread(target=worker, args=(cmd_queue,))
    worker_thread.start()

    # 主线程处理绘图GUI
    plot_controller(cmd_queue)

    # 等待子线程结束
    worker_thread.join()

关键说明 #

• GUI操作必须在主线程：plot_controller函数运行在主线程，负责启动Matplotlib的GUI事件循环，所有窗口操作都在这里执行。
• 线程通信用队列：子线程通过queue发送指令，避免直接操作GUI，保证线程安全。
• 适配GUI后端：代码使用TkAgg后端，如果你用的是QtAgg等其他后端，只需调整对应的画布绑定逻辑即可（核心逻辑不变）。
• 手动关闭的替代方式：如果需要用户手动点击窗口的关闭按钮，只需在plot_controller中移除队列监听逻辑，Tkinter会自动处理窗口关闭事件，不会阻塞主线程。

内容的提问来源于stack exchange，提问作者محمد سلیمیان