使用Pytube与Tkinter开发时，下载任务中进度条不更新的问题

问题根源 #

你遇到的核心问题是PyTube的同步下载操作会阻塞Tkinter的主线程事件循环。Tkinter的UI渲染、交互完全依赖主线程的事件循环，一旦主线程被下载任务占用，哪怕你在回调里调用update_idletasks()，也没有机会执行——主线程根本腾不出时间处理UI更新。

解决方案：用子线程隔离下载任务 #

把下载逻辑放到单独的子线程中执行，让主线程专注处理UI事件。同时注意：Tkinter的控件操作必须在主线程进行，所以进度回调里的UI更新要通过after()方法转交到主线程。

示例代码 #

import tkinter as tk
from tkinter import ttk
from pytube import YouTube
import threading

def download_task(url):
    """子线程中执行的下载逻辑"""
    try:
        yt = YouTube(
            url,
            on_progress_callback=update_progress
        )
        stream = yt.streams.get_highest_resolution()
        stream.download()
    except Exception as e:
        print(f"下载失败: {str(e)}")

def update_progress(stream, chunk, bytes_remaining):
    """进度回调，将UI更新操作提交到主线程"""
    total_size = stream.filesize
    downloaded = total_size - bytes_remaining
    percentage = (downloaded / total_size) * 100
    # 使用after()让进度条更新在主线程执行
    window.after(0, lambda: progress_bar.config(value=percentage))

def start_download():
    """按钮点击触发，启动子线程"""
    video_url = url_input.get().strip()
    if not video_url:
        return
    # 启动守护线程，避免程序退出时残留线程
    threading.Thread(target=download_task, args=(video_url,), daemon=True).start()

# 搭建UI
window = tk.Tk()
window.title("YouTube视频下载器")

url_label = ttk.Label(window, text="视频URL:")
url_label.pack(pady=8)

url_input = ttk.Entry(window, width=60)
url_input.pack(pady=8)

download_btn = ttk.Button(window, text="开始下载", command=start_download)
download_btn.pack(pady=12)

progress_bar = ttk.Progressbar(
    window,
    orient="horizontal",
    length=400,
    mode="determinate"
)
progress_bar.pack(pady=8)

window.mainloop()

关键说明 #

1. 子线程隔离下载：用threading.Thread把download_task放到子线程，主线程不会被阻塞，能正常响应UI事件。
2. 主线程更新UI：update_progress是PyTube在子线程中调用的，不能直接操作Tkinter控件，所以用window.after(0, ...)把进度条更新的任务放到主线程的事件队列里，确保UI操作安全有效。
3. 无需手动调用update_idletasks()：主线程事件循环正常运行时，会自动处理UI刷新，不需要额外手动触发。

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