Tkinter打包.exe运行YOLO模型时出现窗口重复及卡顿问题

一、解决Tkinter卡顿问题（YOLO模型运算阻塞主线程） #

Tkinter的UI渲染完全依赖主线程，模型推理这类高运算量任务必须放到子线程执行，且所有Tkinter的UI操作只能在主线程中进行——这是之前线程方案失败的核心原因。

正确实现方式： #

• 将YOLO推理逻辑封装为独立函数，放在子线程中运行
• 推理完成后，通过after()方法通知主线程更新UI，禁止子线程直接操作UI组件

代码示例：

import tkinter as tk
from tkinter import filedialog
import threading
from ultralytics import YOLO

class YOLOAnalyzer:
    def __init__(self, root):
        self.root = root
        self.model = YOLO("custom_model.pt")
        
        # 初始化UI组件
        self.status_label = tk.Label(root, text="等待选择图片")
        self.status_label.pack(pady=15)
        self.select_btn = tk.Button(root, text="选择图片分析", command=self.launch_inference_thread)
        self.select_btn.pack(pady=5)

    def launch_inference_thread(self):
        # 禁用按钮防止重复触发
        self.select_btn.config(state=tk.DISABLED)
        self.status_label.config(text="模型分析中...")
        
        img_path = filedialog.askopenfilename(filetypes=[("图片文件", "*.jpg;*.png")])
        if img_path:
            # 启动子线程执行推理
            threading.Thread(target=self.run_yolo, args=(img_path,), daemon=True).start()

    def run_yolo(self, img_path):
        # 子线程仅处理模型运算
        results = self.model(img_path)
        # 提取需要展示的结果（示例为检测目标数量）
        result_content = f"检测到 {len(results[0].boxes)} 个目标"
        # 通知主线程更新UI
        self.root.after(0, self.refresh_ui, result_content)

    def refresh_ui(self, content):
        # 主线程中更新UI状态
        self.status_label.config(text=content)
        self.select_btn.config(state=tk.NORMAL)

if __name__ == "__main__":
    root = tk.Tk()
    root.title("YOLO图片分析工具")
    app = YOLOAnalyzer(root)
    root.mainloop()

二、解决打包为.exe后窗口重复的问题 #

打包后出现多窗口，通常是PyInstaller重复触发了主脚本的入口逻辑，或者Tkinter初始化被多次执行。

修复方案： #

1. 打包时使用--noconsole参数（无需控制台时），同时确保入口逻辑严格包裹：

pyinstaller --noconsole --onefile your_app.py

2. 若涉及多进程（注意和线程的区别），必须在入口处添加freeze_support()：

from multiprocessing import freeze_support

if __name__ == "__main__":
    freeze_support()
    root = tk.Tk()
    # 后续初始化逻辑

3. 避免主脚本被当作模块重复导入，确保所有Tkinter窗口初始化代码都在if __name__ == "__main__"块内。

排查关键点 #

• 检查线程代码是否存在直接调用Tkinter组件方法的情况，这类操作必须移到主线程用after()执行
• 先使用--onedir模式打包（而非--onefile），更容易排查文件加载或重复执行的问题
• 确认自定义YOLO模型文件在打包时被正确包含（可通过PyInstaller的--add-data参数指定）

内容的提问来源于stack exchange，提问作者Mitchell de Vries