使用Threading时Canvas动画无法运行的问题排查（Python Tkinter）

DevOps 小满

2026-6-29

问题描述

我正在开发一款媒体管理工具，需在选择目录后加载图片EXIF数据的后台处理阶段，显示带有Canvas动画的加载弹窗。未使用Threading时程序卡顿，添加Threading后弹窗可正常创建，但Canvas的气泡动画循环无法运行，请求协助排查问题。

Main.py

import tkinter as tk
import customtkinter as ctk
from utilities import *
from CTkTable import CTkTable
from test import BubbleFrame

class App(ctk.CTk):
        def __init__(self):
                                
                # setup
                super().__init__()
                ctk.set_appearance_mode('light')
                self.geometry('1000x600')
                self.title('Media Management')
                self.resizable(0,0)

                self.top_frame = ctk.CTkFrame(master=self, fg_color="#bb22d6",  width=600, height=100, corner_radius=0)
                self.top_frame.pack_propagate(0)
                self.top_frame.pack(fill="x", anchor="n", side="top")

                self.path_string = ctk.StringVar()

                ctk.CTkButton(
                        master=self.top_frame, 
                        text="Open Directory", 
                        fg_color="#fff", 
                        font=("Arial Bold", 14), 
                        text_color="#2A8C55", 
                        hover_color="#eee", 
                        anchor="center",
                        command=lambda: open_file_dialog(self, self.top_frame, load_spinner_popup)
                        ).pack(
                                anchor="w", 
                                ipady=(5),
                                padx=(10),
                                pady=(10)
                                )

                ctk.CTkEntry(
                        master=self.top_frame,
                        textvariable = self.path_string,
                        font=("Arial Bold", 12), 
                        text_color="#2A8C55",
                        width= 400
                        ).pack(
                                expand = True,
                                fill = 'y',
                                anchor = 'w',
                                padx = 10, 
                                pady = 10)
        
                def load_spinner_popup(self, top_frame):
                        top= tk.Toplevel(top_frame)
                        top.geometry("750x250")
                        top.title("Loading Files")
                        bubbles = BubbleFrame(top)
                        bubbles.loop(top)
                        #tk.Label(top, text= "Loading Files!", font=('Mistral 18 bold')).place(x=150,y=80)
                        return(top)     

                #run
                self.mainloop()

App()

utilities.py

from dbconnection import *
from datetime import datetime as dt
import os
from tkinter import filedialog
from pathlib import Path
from CTkTable import CTkTable
import customtkinter as ctk
import exiftool
from imagefile import ImageFile
import tkinter as tk
import threading

# function: open_file_dialog
# opens the file dialog pop-up to select a directory and sets the path_string variable
def open_file_dialog(self, top_frame, load_spinner_popup):
    self.path_string.set(filedialog.askdirectory())
    top = threading.Thread(target=load_spinner_popup(self, top_frame)).start()
    self.update()
    self.image_table = load_img_table(self, top)

def load_img_table(self, top):

    self.file_table_frame = ctk.CTkFrame(master=self, fg_color="#bb22d6",  width=600, height=300, corner_radius=0, border_color="#FFF", border_width=5)
    self.file_table_frame.pack_propagate(0)
    self.file_table_frame.pack(fill="x", anchor="n", side="top")

    self.image_list = get_dir_of_imgs(self.path_string)

    self.table_frame = ctk.CTkScrollableFrame(master=self.file_table_frame, fg_color="transparent")
    self.table_frame.pack(expand=True, fill="both", padx=27, pady=21)

    self.table = CTkTable(master=self.table_frame, values=self.image_list, colors=["#E6E6E6", "#EEEEEE"], header_color="#2A8C55", hover_color="#B4B4B4")
    self.table.edit_row(0, text_color="#fff", hover_color="#2A8C55")
    self.table.pack(expand=True)

    close_spinner_popup(top)

def get_dir_of_imgs(path_string):
    image_list = [['Image Name', 'Image Type', 'Created Date', 'Location']]
    images = Path(path_string.get()).glob("*.jpg")
    for image in images:
        img_file = ImageFile(image)
        createDate = img_file.createDate
        address = img_file.address
        image_list.append([image.name, image.suffix, createDate, address])
    return(image_list)

def get_exif_data(path):
    with exiftool.ExifTool() as et:
        files = [path]
        metadata = et.get_metadata_batch(files)
    return(metadata)

def close_spinner_popup(top):
    top.destroy()

test.py

import tkinter as tk
import random

class BubbleFrame:

    def __init__(self, root):
        root.title("Math Bubbles")
        #tk.Button(root, text="Add Bubbles", width=8, command=self.bubble).pack()
        tk.Button(root, text="Quit", width=8, command=quit).pack()
        self.canvas = tk.Canvas(root, width=800, height=650, bg = '#afeeee')
        self.canvas.pack()
        self.bubbles = {} # this will hold bubbles ids, positions and velocities
        self.bubble() 

    def bubble(self):
        # add bubbles for numbers from 1 to 20
        for number in range(1, 20+1):
            xval = random.randint(5,765)
            yval = random.randint(5,615)
            s1 = self.canvas.create_oval(xval,yval,xval+30,yval+30, fill="#00ffff",outline="#00bfff",width=5)
            s2 = self.canvas.create_text(xval+15,yval+15, text=number)
            self.bubbles[(s1, s2)] = (xval, yval, 0, 0) # add bubbles to dictionary

    def loop(self, root):
        for (s1, s2), (x, y, dx, dy) in self.bubbles.items():
            # update velocities and positions
            dx += random.randint(-1, 1)
            dy += random.randint(-1, 1)
            # dx and dy should not be too large
            dx, dy = max(-5, min(dx, 5)), max(-5, min(dy, 5))
            # bounce off walls
            if not 0 < x < 770: dx = -dx
            if not 0 < y < 620: dy = -dy
            # apply new velocities
            self.canvas.move(s1, dx, dy)
            self.canvas.move(s2, dx, dy)
            self.bubbles[(s1, s2)] = (x + dx, y + dy, dx, dy)
        # have mainloop repeat this after 100 ms
        root.after(100, self.loop, root)

#if __name__ == "__main__":
#    root = tk.Tk()
#    frame = BubbleFrame(root)
#    frame.loop(root)
#    root.mainloop()

问题排查与解决方案

核心问题分析

线程创建逻辑错误：threading.Thread(target=load_spinner_popup(self, top_frame))会直接执行load_spinner_popup函数，而非将其作为线程目标。线程实际执行的是函数返回的None，完全起不到异步效果。
GUI操作跨线程违规：Tkinter所有GUI操作（弹窗创建、Canvas动画）必须在主线程执行，子线程中运行GUI逻辑会导致动画循环无法触发。
耗时任务阻塞主线程：load_img_table包含EXIF读取等耗时操作，却在主线程直接调用，阻塞了GUI事件循环，导致弹窗动画无法更新。

修改步骤

1. 调整线程分工（utilities.py）

将耗时任务放入子线程，弹窗创建留在主线程：

def open_file_dialog(self, top_frame, load_spinner_popup):
    self.path_string.set(filedialog.askdirectory())
    # 主线程创建加载弹窗并启动动画
    top = load_spinner_popup(self, top_frame)
    # 子线程执行耗时的图片加载与表格生成
    threading.Thread(target=load_img_table, args=(self, top), daemon=True).start()

2. 确保弹窗销毁在主线程（utilities.py）

Tkinter组件操作必须在主线程执行，修改关闭弹窗的逻辑：

def close_spinner_popup(top):
    # 通过after切换到主线程执行销毁
    top.after(0, top.destroy)

3. 保留主线程创建弹窗的逻辑（Main.py）

load_spinner_popup无需修改，保持在主线程创建弹窗并启动动画：

def load_spinner_popup(self, top_frame):
        top= tk.Toplevel(top_frame)
        top.geometry("750x250")
        top.title("Loading Files")
        bubbles = BubbleFrame(top)
        bubbles.loop(top)
        return(top)

原理说明

主线程负责所有GUI操作：创建弹窗、启动Canvas的after动画循环，保证GUI事件循环正常运行。
子线程仅处理IO密集型任务（读取EXIF、生成表格数据），避免阻塞主线程。
任务完成后，通过top.after(0, ...)将弹窗销毁操作切回主线程，符合Tkinter线程安全规则。

内容的提问来源于stack exchange，提问作者Chris Orr

使用Threading时Canvas动画无法运行的问题排查（Python Tkinter）

Main.py #

utilities.py #

test.py #

核心问题分析 #

修改步骤 #