基于Tkinter的CSV处理程序实现可显隐进度条避免窗口冻结问题咨询

现有代码核心问题 #

• 同时创建了2个tk.Tk()实例：Tkinter 进程内仅允许存在1个主Tk实例，额外窗口必须使用tk.Toplevel()创建，否则会出现消息循环异常、资源冲突问题
• 子线程直接操作UI元素：Tkinter 不是线程安全框架，所有UI修改必须在主线程执行，子线程需通过after()方法向主线程提交UI操作请求
• 执行逻辑顺序错误：root2.mainloop()后的代码（按钮创建、主窗口消息循环）会在root2关闭后才执行，完全不符合交互逻辑

修改后可运行代码 #

import threading
from time import sleep
import tkinter as tk
import tkinter.ttk as ttk
from tkinter.messagebox import askyesno

root = tk.Tk()
root.title('CSV转PDF工具')
label = tk.Label(text = '点击按钮开始处理')
label.pack()

# 进度条窗口全局变量
progress_win = None
progress_bar = None
# 线程同步用：存储用户选择、阻塞业务线程等待用户操作
user_choice = None
user_input_event = threading.Event()

class ProcessThread(threading.Thread):
    def __init__(self, threadID):
        threading.Thread.__init__(self)
        self.threadID = threadID
        # 守护线程，主窗口关闭时自动退出
        self.daemon = True

    def run(self):
        process_logic()

def show_progress():
    """主线程调用：显示进度条窗口"""
    global progress_win, progress_bar
    progress_win = tk.Toplevel(root)
    progress_win.title("处理中")
    progress_win.geometry("400x170")
    # 禁止用户手动关闭进度条窗口
    progress_win.protocol("WM_DELETE_WINDOW", lambda: None)
    tk.Label(progress_win, text='正在处理数据，请稍候', justify=tk.CENTER, bg="#CBFDCB").place(x=43, y=30)
    progress_bar = ttk.Progressbar(progress_win, orient="horizontal",
                                   mode="indeterminate", takefocus=True, length=320)
    progress_bar.place(x=40, y=80)
    progress_bar.start()

def hide_progress():
    """主线程调用：隐藏进度条窗口"""
    if progress_win and progress_win.winfo_exists():
        progress_win.withdraw()

def show_progress_again():
    """主线程调用：重新显示进度条窗口"""
    if progress_win and progress_win.winfo_exists():
        progress_win.deiconify()

def close_progress():
    """主线程调用：关闭进度条窗口"""
    global progress_win, progress_bar
    if progress_win and progress_win.winfo_exists():
        progress_bar.stop()
        progress_win.destroy()
        progress_win = None
        progress_bar = None

def ask_user_question():
    """主线程调用：弹出用户问询，完成后恢复进度条并通知业务线程"""
    global user_choice
    hide_progress()
    # 弹出问询框
    choice = askyesno("确认操作", "检测到CSV包含特殊格式，是否保留格式导出PDF？")
    user_choice = choice
    show_progress_again()
    # 通知业务线程用户已选择，可以继续执行
    user_input_event.set()

def process_logic():
    """业务逻辑：完全在子线程运行，不直接操作UI"""
    global user_choice
    # 第一步：CSV预处理
    sleep(2) # 模拟处理耗时
    # 第二步：需要弹出用户问询，通知主线程操作
    user_input_event.clear()
    root.after(0, ask_user_question)
    # 等待用户完成选择
    user_input_event.wait()
    # 第三步：根据用户选择继续处理
    if user_choice:
        # 保留格式导出逻辑
        sleep(2) # 模拟处理耗时
    else:
        # 不保留格式导出逻辑
        sleep(1) # 模拟处理耗时
    # 处理完成，通知主线程关闭进度条+更新状态
    root.after(0, close_progress)
    root.after(0, lambda: label.config(text="处理完成，PDF已导出"))

def start_process():
    """点击按钮触发的启动函数"""
    label.config(text="开始处理数据...")
    # 显示进度条
    show_progress()
    # 启动业务线程
    th = ProcessThread(1)
    th.start()

Button1 = tk.Button(root, text="开始处理CSV", padx=10,
                    pady=5, fg="white", bg="#263D42", command=start_process)
Button1.pack()

root.mainloop()

适配说明 #

你只需要把process_logic函数里的sleep替换为你实际的CSV解析、PDF生成逻辑即可，不需要修改其他框架代码：

• 业务逻辑全程在子线程运行，不会卡住主窗口
• 要弹出用户问询时，直接按照代码示例的方式调用root.after(0, 弹框函数)，配合user_input_event等待用户选择即可，会自动隐藏/恢复进度条

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