使用Concurrent Futures线程更新Tkinter GUI时程序无响应问题

核心问题 #

你的代码导致GUI冻结的原因有两个：

1. task.result()是阻塞调用：主线程会等待子线程完成下载任务，期间无法处理GUI事件，直接导致界面无响应。
2. 子线程中调用Tkinter GUI操作：filedialog.askdirectory()属于GUI操作，Tkinter要求所有GUI相关操作必须在主线程执行，子线程调用会引发异常或无响应。

修复方案 #

将GUI相关操作移到主线程，子线程仅处理耗时的下载逻辑，通过回调函数在任务完成后更新GUI状态。

方案1：使用ThreadPoolExecutor + 回调函数

def start_download():
    # 主线程处理GUI操作：获取URL、验证、选择文件夹
    URL = url.get()
    is_valid = is_valid_url(URL)
    if not is_valid:
        status.set("Invalid URL")
        return
    
    path = filedialog.askdirectory()
    if path == "":
        status.set("Invalid Directory!")
        return
    
    # 提交下载任务到线程池，不阻塞主线程
    with ThreadPoolExecutor() as executor:
        executor.submit(download_task, URL, path).add_done_callback(on_download_finish)

def download_task(URL, path):
    # 子线程仅处理下载逻辑，无任何GUI操作
    try:
        yt = YouTube(URL)
        streams = yt.streams.filter(progressive=True, file_extension="mp4")
        highest_res = streams.get_highest_resolution()
        highest_res.download(output_path=path)
        return "Downloaded Successfully!"
    except Exception as e:
        return f"Download failed: {str(e)}"

def on_download_finish(future):
    # 回调函数：在主线程更新GUI状态
    result = future.result()
    status.set(result)

方案2：使用threading.Thread + 回调

如果你更倾向于原生线程模块，也可以用这种方式：

import threading

def start_download():
    # 主线程处理GUI操作
    URL = url.get()
    is_valid = is_valid_url(URL)
    if not is_valid:
        status.set("Invalid URL")
        return
    
    path = filedialog.askdirectory()
    if path == "":
        status.set("Invalid Directory!")
        return
    
    # 创建并启动子线程，传递下载参数和回调函数
    thread = threading.Thread(target=download_with_callback, args=(URL, path, update_status))
    thread.start()

def download_with_callback(URL, path, callback):
    try:
        yt = YouTube(URL)
        streams = yt.streams.filter(progressive=True, file_extension="mp4")
        highest_res = streams.get_highest_resolution()
        highest_res.download(output_path=path)
        callback("Downloaded Successfully!")
    except Exception as e:
        callback(f"Download failed: {str(e)}")

def update_status(result):
    # 主线程中更新状态
    status.set(result)

关键注意事项 #

• 所有Tkinter组件的读写、对话框弹出必须在主线程执行。
• 子线程仅负责耗时的非GUI任务（如下载、计算），避免阻塞主线程。
• 不要在主线程中调用任何阻塞方法（如task.result()、thread.join()），否则会导致GUI冻结。

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