Tkinter Designer

← Guías de tkinter

¿Por qué mi ventana de tkinter se congela o dice "No responde" durante una tarea larga?

Todo en tkinter, incluido redibujar la ventana, ocurre en un solo hilo dentro de mainloop(). Mientras corre el comando de un botón (una descarga, una consulta a la base de datos, un time.sleep, un bucle grande) ese hilo está ocupado: no se dibuja nada y el sistema operativo marca la ventana como "No responde". La solución es ejecutar la parte lenta en un hilo aparte y devolver el resultado a tkinter con after():

import threading
import time
import tkinter as tk
from tkinter import messagebox


def slow_task():
    time.sleep(3)  # en lugar de una descarga, una consulta, un bucle grande
    return "Terminado"


def on_click():
    button.configure(state="disabled")  # nada de un segundo trabajo mientras corre
    status.configure(text="Trabajando...")
    threading.Thread(target=work, daemon=True).start()


def work():
    # Corre en segundo plano: aquí no toques ningún widget.
    try:
        result, error = slow_task(), None
    except Exception as e:
        result, error = None, e
    root.after(0, done, result, error)


def done(result, error):
    # De vuelta en el hilo de tkinter: ya es seguro actualizar widgets.
    button.configure(state="normal")
    if error is not None:
        status.configure(text="")
        messagebox.showerror("Algo salió mal", str(error))
    else:
        status.configure(text=result)


root = tk.Tk()
button = tk.Button(root, text="Iniciar", command=on_click)
button.pack(padx=20, pady=(20, 8))
status = tk.Label(root, text="")
status.pack(padx=20, pady=(0, 20))
root.mainloop()

Toca los widgets solo desde el hilo principal

Tkinter no es seguro para hilos. Llamar a label.configure() directamente desde el hilo de trabajo muchas veces parece funcionar y luego falla al azar con RuntimeError: main thread is not in main loop o Tcl_AsyncDelete: async handler deleted by the wrong thread, lo que lo convierte en uno de los errores de tkinter más difíciles de rastrear. Por eso el hilo de trabajo solo calcula, y todo lo visible ocurre en una función que after ejecuta en el propio hilo de tkinter.

root.after(0, done, result, error) es la forma habitual de devolver el resultado, porque solo programa la llamada. Para la versión más estricta, haz que el hilo deje los resultados en una queue.Queue y que el hilo principal la revise con after cada 100 ms, así el hilo de trabajo nunca llama a tkinter.

Mostrar el progreso mientras corre

La misma regla vale para una barra de progreso: el hilo de trabajo informa un número y after lo aplica. Desactiva además el botón mientras dura la tarea, o un segundo clic impaciente arranca otro hilo haciendo el mismo trabajo.

Cuando no hay forma de saber cuánto falta, usa una barra indeterminada: llama a bar.start() antes de arrancar el hilo y a bar.stop() en la función final, y se anima sola mientras dura el trabajo.

from tkinter import ttk

bar = ttk.Progressbar(root, maximum=100)

def work():
    for i, item in enumerate(items):
        process(item)                      # la parte lenta
        percent = (i + 1) * 100 / len(items)
        root.after(0, lambda p=percent: bar.configure(value=p))

Por qué llamar a update() en el bucle no es la solución

Llenar un bucle largo de root.update() sí hace que la ventana se redibuje, y por eso es una respuesta tan común. Pero ejecuta todos los eventos pendientes dentro de tu bucle, incluido un segundo clic en el mismo botón, que vuelve a arrancar el manejador antes de que termine el primero. Y no sirve de nada durante una sola llamada lenta: la ventana sigue colgada durante todo un requests.get().

Cuando no hace falta ningún hilo

Si el trabajo son muchos pasos pequeños y rápidos (una animación, una cuenta regresiva, recorrer una lista) no necesitas un hilo. Haz un paso, programa el siguiente con after, y la ventana sigue respondiendo entre paso y paso porque el control vuelve a mainloop() cada vez.

def count_down(n):
    status.configure(text=str(n))
    if n > 0:
        root.after(1000, count_down, n - 1)   # vuelve a llamarse en un segundo

count_down(10)

Cerrar la ventana mientras corre la tarea

daemon=True es lo que permite que el programa termine si se cierra la ventana a mitad de la tarea; sin eso, Python espera a que el hilo acabe y la aplicación parece colgarse al cerrar. Un hilo daemon simplemente se abandona, así que una tarea que escribe archivos debería revisar un threading.Event y detenerse en un punto seguro. Python no tiene forma de matar un hilo desde fuera.

stop = threading.Event()

def work():
    for item in items:
        if stop.is_set():
            return          # termina limpio, con los archivos cerrados
        process(item)

root.protocol("WM_DELETE_WINDOW", lambda: (stop.set(), root.destroy()))

Hacerlo sin buscarlo

Selecciona un botón y marca Ejecutar en segundo plano en el inspector. El código exportado divide su manejador en un método de clic que desactiva el botón y arranca un hilo daemon, un método _work para tu código lento y un método _done que vuelve al hilo de la ventana y muestra cualquier excepción en un cuadro de error. Elige una barra de progreso y una etiqueta de estado y agrega un ayudante _report que las actualiza de forma segura desde el segundo plano. Es gratis y funciona igual en tkinter puro, CustomTkinter y ttkbootstrap.

Este ejemplo está listo para abrir: cámbialo en el lienzo y mira cómo se actualiza el Python.

Abrir este ejemplo en el diseñador →

Preguntas relacionadas