Python 2.7基于Tkinter实现Excel转JSON时同步显示loading gif问题

所有主流Python桌面GUI框架（Tkinter、PyQt/PySide、wxPython等）均采用单线程事件循环模型，UI渲染、用户交互响应、自定义逻辑默认都在主线程执行。你当前代码的执行逻辑是：点击按钮→触发回调→先执行显示loading的代码→紧接着执行Excel读取+JSON转换的耗时逻辑，而耗时逻辑会阻塞主线程的事件循环，导致显示loading的渲染指令一直排队，直到耗时逻辑执行完成、主线程空闲后才会被渲染，因此出现界面冻结、loading延迟显示的问题。

核心逻辑是将耗时逻辑和UI更新逻辑拆分到不同线程执行：

• 第一步：按钮点击触发回调后，先在主线程启动loading动画的显示，确保渲染指令第一时间被执行
• 第二步：启动独立的工作线程/异步任务，执行Excel读取、数据转换等耗时逻辑，全程不要在工作线程里直接操作UI控件
• 第三步：耗时逻辑执行完成/抛出异常时，通过框架提供的线程安全信号/回调机制，通知主线程关闭loading动画，同时更新后续UI（比如展示转换结果、弹出错误提示）

PyQt/PySide 代码示例 #

from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton, QLabel
from PySide6.QtCore import QThread, Signal
import pandas as pd
import json

# 自定义工作线程
class DataProcessThread(QThread):
    # 完成信号，携带转换后的json数据
    process_finished = Signal(str)
    # 错误信号
    process_error = Signal(str)

    def run(self):
        try:
            # 耗时逻辑全放这里
            df = pd.read_excel("your_file.xlsx")
            json_data = df.to_json(orient="records")
            self.process_finished.emit(json_data)
        except Exception as e:
            self.process_error.emit(str(e))

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.loading_label = QLabel("加载中...", self)
        self.loading_label.hide()
        self.load_btn = QPushButton("load data", self)
        self.load_btn.clicked.connect(self.on_load_click)

    def on_load_click(self):
        # 主线程先显示loading
        self.loading_label.show()
        # 禁用按钮避免重复点击
        self.load_btn.setDisabled(True)
        # 启动工作线程
        self.worker_thread = DataProcessThread()
        # 绑定线程信号回调，全部在主线程执行
        self.worker_thread.process_finished.connect(self.on_process_done)
        self.worker_thread.process_error.connect(self.on_process_error)
        self.worker_thread.start()

    def on_process_done(self, json_data):
        # 关闭loading，处理结果
        self.loading_label.hide()
        self.load_btn.setDisabled(False)
        # 后续处理json数据的逻辑
        print("转换完成", json_data)

    def on_process_error(self, error_msg):
        self.loading_label.hide()
        self.load_btn.setDisabled(False)
        print("处理失败", error_msg)

Tkinter 代码示例 #

Tkinter可通过threading模块加after方法实现线程安全的UI更新：

import tkinter as tk
import threading
import pandas as pd
import json

class App:
    def __init__(self, root):
        self.root = root
        self.loading_label = tk.Label(root, text="加载中...")
        self.loading_label.pack_forget()
        self.load_btn = tk.Button(root, text="load data", command=self.on_load_click)
        self.load_btn.pack()

    def process_data(self):
        try:
            df = pd.read_excel("your_file.xlsx")
            json_data = df.to_json(orient="records")
            # 用after方法调度到主线程执行UI更新
            self.root.after(0, self.on_process_done, json_data)
        except Exception as e:
            self.root.after(0, self.on_process_error, str(e))

    def on_load_click(self):
        # 先显示loading
        self.loading_label.pack()
        self.load_btn.config(state=tk.DISABLED)
        # 启动工作线程
        threading.Thread(target=self.process_data, daemon=True).start()

    def on_process_done(self, json_data):
        self.loading_label.pack_forget()
        self.load_btn.config(state=tk.NORMAL)
        print("转换完成", json_data)

    def on_process_error(self, error_msg):
        self.loading_label.pack_forget()
        self.load_btn.config(state=tk.NORMAL)
        print("处理失败", error_msg)

• 绝对不要在工作线程中直接操作UI控件，不同GUI框架的UI控件都不是线程安全的，直接跨线程操作会导致意外崩溃、渲染异常等问题
• 耗时操作包含磁盘IO（读取Excel文件）、CPU密集计算（数据转换）两类，都需要放到工作线程执行
• 可以根据需要在线程中加入进度信号，实时更新加载进度条的数值

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