Cómo depurar código paso a paso cuando no sabes qué falla
Cuando un programa falla, cambiar líneas al azar parece rápido, pero elimina pistas y crea errores nuevos. Depurar es convertir “no funciona” en una pregunta concreta que puedes comprobar.
1. Describe el resultado esperado y el real
Evita frases generales. Anota qué entrada utilizas, qué esperabas obtener y qué ocurre exactamente. “Con la lista vacía debería mostrar cero, pero lanza un error en la línea 24” ya permite investigar.
2. Consigue reproducir el fallo
Un error reproducible es mucho más fácil de resolver. Reduce los pasos y guarda los datos exactos que lo provocan. Si unas veces ocurre y otras no, compara qué cambia: orden, tiempo, estado previo o entorno.
3. Lee el primer mensaje útil
En una traza larga, localiza primero el tipo de error y la primera referencia a un archivo de tu proyecto. Lee también las líneas anteriores: a menudo indican qué operación recibió un valor inesperado.
No copies todo el mensaje en un buscador antes de entender sus partes. Identifica lenguaje, biblioteca, operación y dato implicado. Así podrás formular una consulta precisa si necesitas documentación.
4. Reduce la zona sospechosa
Comprueba qué partes sí funcionan. Si los datos se cargan correctamente pero el cálculo final es erróneo, el problema está después de la carga. Añade puntos de interrupción o salidas temporales en fronteras lógicas, no después de cada línea.
El objetivo es acotar: entrada correcta aquí, salida incorrecta allí. Cuanto menor sea ese intervalo, menos hipótesis necesitas.
5. Observa valores, no supongas
Mira el valor y el tipo de cada variable relevante. Comprueba cuántas veces entra en un bucle y qué condición decide una rama. Muchos bloqueos duran porque el programador razona sobre el valor que cree tener, no sobre el valor real.
6. Formula una hipótesis y cambia una cosa
Escribe una frase: “Creo que falla porque la lista está vacía cuando accedemos al primer elemento”. Luego diseña una comprobación que pueda demostrarlo o descartarlo.
Haz un cambio cada vez y vuelve a ejecutar el caso mínimo. Si el cambio corrige el síntoma, comprueba por qué. Añade también un caso que asegure que la solución no rompe el comportamiento normal.
7. Conserva lo aprendido
Antes de cerrar, resume causa y solución. Si el error puede repetirse, añade una validación o una prueba. Depurar bien no termina cuando desaparece el mensaje: termina cuando entiendes la causa y has reducido la probabilidad de repetirla.
Esta secuencia —reproducir, aislar, observar, plantear y comprobar— funciona en Java, Python, JavaScript y casi cualquier entorno. Practicarla te hace más autónomo que memorizar la corrección de un caso concreto.
Si los errores que repites son de Java, tienes las causas más habituales en los errores de Java más comunes en primero de DAM y DAW. Y si prefieres depurar acompañado sobre tu propio proyecto, así trabajamos en las clases de programación para DAM y DAW.