Usa Run Code / Run (Ejecutar Código) cuando quieras ejecutar tu programa y ver su salida. Usa Debug (Depurar) cuando quieras pausar en una línea, inspeccionar variables y averiguar por qué un resultado es incorrecto. La depuración es especialmente útil cuando tu código se ejecuta sin errores pero produce una respuesta inesperada.

Esta guía utiliza el ejecutor de Python de CodeUtility y un pequeño ejemplo de cálculo. El flujo de trabajo de punto de interrupción y paso también se aplica a otros ejecutores donde está disponible Depurar. El soporte y los controles en tiempo de ejecución pueden variar; usa un servidor de tiempo de ejecución compatible para esta guía de Python. Las capturas de pantalla muestran la interfaz en inglés.

1. Prueba un pequeño programa con un error lógico

Abre el ejecutor de Python, elige Python 3.11 en el menú de versiones y escribe las siguientes cuatro líneas. Un precio de 12 multiplicado por una cantidad de 3 debería dar 36. Este programa utiliza deliberadamente la suma, por lo que produce 15.

price = 12
quantity = 3
total = price + quantity
print(total)

2. Establece un punto de interrupción antes de comenzar a depurar

Haz clic en el margen izquierdo junto a la línea 3, la línea que contiene total = price + quantity. Aparece un marcador de punto de interrupción rojo. Un punto de interrupción le dice al depurador dónde pausar. Haz clic en el marcador nuevamente para eliminarlo. Coloca puntos de interrupción en declaraciones ejecutables en lugar de líneas en blanco o comentarios.

Un punto de interrupción rojo junto a la línea 3 marca dónde debe pausar la ejecución.
Un punto de interrupción rojo junto a la línea 3 marca dónde debe pausar la ejecución.

3. Inicia la depuración e inspecciona los valores

Selecciona Debug (Depurar) en la barra de herramientas del editor; pasa el cursor sobre un ícono para ver su etiqueta. Espera a que la ventana del depurador informe Paused at line 3 (Pausado en la línea 3). Pausado significa que el programa está esperando tu próxima acción de depuración.

Mira bajo VARIABLES: price es 12 y quantity es 3. La línea 3 aún no se ha ejecutado, por lo que total no está listado. La línea resaltada es la siguiente declaración a ejecutar. La CALL STACK (PILA DE LLAMADAS) muestra dónde está actualmente pausada la ejecución.

Pausado antes de la línea 3: el precio es 12 y la cantidad es 3; total aún no ha sido asignado.
Pausado antes de la línea 3: el precio es 12 y la cantidad es 3; total aún no ha sido asignado.

4. Avanza en el cálculo

Haz clic en Step Over (Paso Sobre) una vez. La ejecución se mueve a la línea 4, y total ahora aparece con el valor 15. Esto muestra que la respuesta incorrecta proviene de sumar los dos valores en la línea 3.

Después de Paso Sobre, el depurador se pausa en la línea 4 y muestra total = 15.
Después de Paso Sobre, el depurador se pausa en la línea 4 y muestra total = 15.

Continue (Continuar) reanuda hasta que se alcance otro punto de interrupción o el programa finalice. Step Over (Paso Sobre) ejecuta la declaración actual sin entrar en una función llamada. Step Into (Paso Dentro) entra en una función llamada cuando es compatible. Step Out (Paso Fuera) ejecuta hasta que la función actual devuelve. Stop (Detener), mostrado como un ícono cuadrado, finaliza la sesión de depuración.

5. Corrige el código y ejecútalo nuevamente

Selecciona Continuar para finalizar el ejemplo, o Detener para terminar la sesión. Reemplaza el signo más en la línea 3 con un signo de multiplicación, luego selecciona Run Code / Run (Ejecutar Código) para verificar la salida. Deberías ver 36. También puedes iniciar Depurar nuevamente y usar Paso Sobre para verificar el valor corregido.

price = 12
quantity = 3
total = price * quantity
print(total)

Si la depuración no se pausa donde esperas

Verifica que un punto de interrupción rojo esté establecido antes de comenzar a depurar, que seleccionaste Depurar y que el programa realmente alcance esa línea. Elige una línea ejecutable y confirma que el tiempo de ejecución seleccionado admite la depuración. Los errores de sintaxis pueden evitar que la ejecución alcance un punto de interrupción. Si tu programa solicita entrada, proporciónala en la terminal para que la ejecución pueda continuar.

Para tu próxima sesión de depuración, coloca un punto de interrupción justo antes del cálculo sospechoso, inspecciona sus entradas y avanza hasta que encuentres el primer valor inesperado. Si solo necesitas la salida final, selecciona Ejecutar Código.