我在Tkinter中实现了一个基于ScrolledText的日志组件，通过自定义TextHandler类（继承logging.Handler）处理日志并输出到组件中。调用logging.info(msg)输出日志时，常规场景运行正常，但当在循环等耗时操作前调用日志时，日志会在循环结束后才显示，而print语句能实时输出。

这个问题我之前也碰到过类似的坑，核心原因就是Tkinter的单线程事件循环机制，我给你拆解一下：

为什么日志会延迟显示？ #

Tkinter的所有UI更新（包括你日志组件里的文本插入、自动滚动）都依赖主线程的事件循环来处理。你在TextHandler的emit方法里用了self.text.after(0, append)，这个方法的作用是把append函数放到Tkinter的事件队列里，等待主事件循环空闲时执行。

但当你运行一个耗时的循环时，主线程被这个循环完全占用了——它一直在执行循环里的代码，根本没时间去处理事件队列里的append任务。所以所有的日志更新请求都被积压着，直到循环结束，主线程回到事件循环，才会一次性处理完这些积压的任务，导致日志一下子全部显示出来。

而print语句是直接向标准输出流写入内容，不经过Tkinter的事件循环，所以它能实时输出，不受主线程阻塞的影响。

怎么解决这个问题？ #

有两种常用的解决方案，你可以根据场景选择：

1. 在循环中手动触发事件循环更新

如果你不想改动太多代码，可以在循环的每次迭代中加入update()方法，让主线程暂时跳出循环，处理一下事件队列里的任务：

# 假设这是你的耗时循环
import time

for i in range(10):
    self.logger.info(f"正在执行第{i}次循环")
    # 手动更新UI事件循环，让日志能实时显示
    self.update()  # 或者用 st.update() 只更新日志组件
    # 模拟耗时操作
    time.sleep(1)

不过这种方式要注意：如果循环迭代非常频繁，频繁调用update()会影响性能；而且如果循环里的任务真的非常耗时，主线程还是会被长时间占用，体验不算最佳。

2. 把耗时操作放到子线程中（推荐）

Tkinter的UI操作必须在主线程执行，但耗时的业务逻辑可以放到子线程里，这样主线程就能一直处理事件循环，保证日志实时显示。

因为你的TextHandler已经用了after(0, append)，这个方法会自动把UI更新任务抛回主线程，所以子线程里调用logging.info是安全的。示例代码如下：

import threading
import time

def long_running_task(self):
    # 这里放你的耗时循环逻辑
    for i in range(10):
        self.logger.info(f"子线程执行第{i}次循环")
        time.sleep(1)

# 启动子线程执行耗时任务，daemon=True让线程随主程序退出
threading.Thread(target=long_running_task, args=(self,), daemon=True).start()

用子线程的方式可以彻底避免主线程阻塞，是Tkinter处理耗时任务的标准做法，推荐优先使用。

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