GuíaAvanzado
Guía de Depuración y Diagnóstico
Toma un fallo desconocido —un traceback de treinta líneas, un resultado silenciosamente incorrecto, una regresión enterrada en doscientos commits o un test que falla uno de cada treinta días— y apréndelo a reproducir, acorralar hasta la línea exacta y explicar con evidencia, antes de pedirle nada a un modelo; y cuando se lo pides, aprende a verificar si la respuesta es correcta. Los seis módulos avanzan de leer el fallo (lo que un traceback ya te está diciendo) al método que va del síntoma a la causa raíz, al depurador para detener el programa y mirar por dentro, al logging para diagnosticar lo que ya pasó, a la bisección para acorralar regresiones y fallos intermitentes, y cierran con la IA en el ciclo: usarla después de entender el error, no en su lugar. El proyecto final es un dossier de depuración sobre un repositorio con cinco fallos de naturaleza distinta —incluida una regresión que exige `git bisect run`— resueltos con protocolo, evidencia y test de regresión.
- 48
- lecciones
- 6
- módulos
- Inglés · Español
- disponible en
- Sí
- certificado
- Gratis
- acceso
Resultados
Lo que vas a poder hacer
- Leer un traceback completo de Python —incluido uno encadenado o de código asíncrono— y ubicar el archivo, la línea y el frame culpable en tu propio código
- Distinguir el síntoma de la causa raíz, reproducir un bug de forma confiable y reducirlo a un ejemplo mínimo reproducible (MRE)
- Formular hipótesis falsables y reconocer los sesgos de razonamiento que alargan una depuración: confirmación, "depuración por escopeta", callejones sin salida
- Usar un depurador —`pdb` y un depurador gráfico como `debugpy`— para detener la ejecución exactamente donde tu hipótesis lo indica, en vez de imprimir a ciegas
- Instrumentar con `logging` (niveles, contexto, excepciones con traceback completo) para diagnosticar fallos que ya ocurrieron y que no puedes reproducir en vivo
- Aplicar bisección —`git bisect`, aislamiento por capas y por datos— para encontrar el commit o la condición exacta que rompió algo
- Convertir un fallo intermitente en uno determinista fijando semillas, tiempo, orden de ejecución o estado compartido
- Ejecutar un protocolo verificable antes de pedirle ayuda a un modelo, y verificar su respuesta reproduciendo el fallo en vez de aplicar el parche a ciegas
- Cerrar un bug con un postmortem de causa raíz y un test de regresión, no solo con el síntoma resuelto
Antes de empezar
Qué necesitas traer
Es para ti si...
- Devs que copian un traceback a un modelo sin haberlo leído primero, y quieren romper ese hábito
- Devs que solo depuran con `print()` y quieren dominar un depurador real: `pdb`, `debugpy`
- Equipos que enfrentan bugs intermitentes, regresiones enterradas en la historia de commits, o fallos que solo ocurren en producción
- Cualquiera que quiera usar IA para depurar sin caer en el bucle de "parche, error nuevo, parche, error nuevo"
Requisitos y materiales
- Python a nivel de funciones, módulos y excepciones (`try/except`), y entornos virtuales
- Git básico: `commit`, `log`, `checkout` — no hace falta `bisect`, se enseña en la guía
- Ejecutar scripts y comandos desde la terminal
Contenido
El temario, módulo por módulo
Abre cualquiera para ver sus lecciones.
- 1. Introducción: el error ya trae la mitad de la respuesta
- 2. El reflejo de copiar y pegar: qué pierdes cuando el modelo responde primero
- 3. Qué es realmente una pila de llamadas
- 4. Recorrer un traceback completo, línea por línea
- 5. Tu código y el de las librerías: dónde está la frontera
- 6. Excepciones encadenadas: seguir la cadena hasta el origen
- 7. Diccionario de excepciones: qué causa hay detrás de cada una
- 8. Proyecto: triage de tracebacks reales
- 1. Introducción: cuando el programa no falla, solo se equivoca
- 2. Síntoma y causa: la distinción que decide si el bug vuelve
- 3. Reproducir antes de arreglar
- 4. El ciclo de hipótesis: depurar como un experimento
- 5. El ejemplo mínimo reproducible
- 6. Sesgos, callejones sin salida y cuándo parar
- 7. El mismo método fuera de Python: navegador, HTTP y contenedores
- 8. Proyecto: de un reporte vago a un informe de causa raíz
- 1. Introducción: dejar de suponer y empezar a mirar
- 2. Depurar con print: cuándo alcanza y cuándo estorba
- 3. Tu primer breakpoint con pdb
- 4. El vocabulario de pdb: moverse y ver el estado
- 5. Estrategia de recorrido: dónde parar y hasta dónde entrar
- 6. Breakpoints condicionales y autopsia tras la excepción
- 7. Depurador gráfico con debugpy en VS Code y Cursor
- 8. Proyecto: cazar un bug silencioso con el depurador
- 1. Introducción: depurar lo que ya ocurrió
- 2. Del print al módulo logging
- 3. Niveles: el criterio de qué va en cada uno
- 4. Registrar excepciones sin destruir la evidencia
- 5. Logs con contexto: de la frase suelta al registro consultable
- 6. Diseñar logs con los que se pueda depurar
- 7. De los logs a la línea de tiempo del fallo
- 8. Proyecto: instrumentar un servicio que falla a veces
- 1. Introducción: cuando ninguna pista alcanza
- 2. La bisección como modelo mental
- 3. git bisect: encontrar el commit que rompió todo
- 4. Aislar por capas y por datos
- 5. «En mi máquina funciona»: entorno y dependencias
- 6. Fallos intermitentes: hacer determinista lo que no lo es
- 7. Cuando «falla» significa lento o sin memoria
- 8. Proyecto: encontrar el commit que rompió la suite
- 1. Introducción: la IA es un buen segundo paso
- 2. Qué hacer antes de pegar el error
- 3. Pedir ayuda bien: a un modelo y a un humano
- 4. Verificar la respuesta: hipótesis, no parche
- 5. Señales de que la IA está empeorando el problema
- 6. Depurar código que ningún humano escribió
- 7. El postmortem: cerrar el bug de verdad
- 8. Proyecto final: dossier de depuración
Dudas frecuentes
Lo que suele preguntarse
Sin límite. Es una guía gratuita: entras cuando quieras, las veces que quieras.
No. Los módulos están ordenados de menos a más, pero puedes saltar al que necesites. Tu progreso se guarda por lección.
Lo que haga falta está en «Qué necesitas traer», arriba. Si no aparece nada ahí, puedes empezar desde cero.
En el grupo de WhatsApp del Club, y cada quince días hay un live con un instructor donde se resuelven dudas en vivo.
Sí. Al terminar todas las lecciones se emite automáticamente, con un código verificable que puedes compartir en LinkedIn.
Empieza cuando quieras
Lo que dicen los estudiantes
Estas reseñas son de estudiantes inscritos que completaron al menos el 50% del curso. Moderamos las reseñas solo por motivos de contenido (spam, lenguaje ofensivo, datos personales), nunca por ser críticas o negativas.
Aún no hay reseñas aprobadas.
¡Sé el primero en compartir tu experiencia!