Troubleshooting
Leer errores sin pánico
Un error rojo no es el fin del mundo. Es una pista.
Vas a ver errores. Mucho. Y está bien: hasta los programadores con 20 años de experiencia los ven todo el día. Un error no significa que hiciste algo mal ni que “no sirves para esto”. Es la compu diciéndote dónde mirar.
El secreto peor guardado
El 90% de las veces, la solución es: copiar el error, pegárselo a la IA y hacer lo que dice. En serio.
Paso 1: no cierres nada, respira
Cuando algo truena, no borres código en pánico. El error tiene la pista. Léelo (aunque suene a chino) — casi siempre menciona un archivo y una línea.
Paso 2: ¿dónde está el error?
Los errores aparecen en 3 lugares. Aprende a mirarlos:
| Dónde | Qué errores | Cómo verlo |
|---|---|---|
| Terminal de Cursor | Al instalar o arrancar (yarn dev) | El panel de abajo, texto en rojo. |
| Overlay del navegador | Al cargar una página rota | Un recuadro rojo grande encima de la web. |
| Consola del navegador | Cosas que fallan “en silencio” | Clic derecho → Inspeccionar → pestaña Console. |
Paso 3: copia el error COMPLETO
No lo describas con tus palabras (“no jala la página”). Copia el texto tal cual, entero. La IA necesita el mensaje exacto, no un resumen.
Paso 4: pégaselo a Cursor
Me sale este error. Explícame en simple qué significa y cómo lo arreglo, paso a paso:[pega el error completo aquí]
Si sigues atorado: pide ayuda bien
Cuando le escribas al docente o a un compañero, da estos 4 datos (así te ayudan rápido):
- Qué intentabas hacer (“seguir el paso 5 de Semana 2”).
- Qué esperabas que pasara.
- Qué pasó en su lugar (el error completo).
- Qué ya intentaste para arreglarlo.
Nunca pegues tus claves
Al compartir un error, revisa que no incluya tu SUPABASE_SERVICE_ROLE_KEY u otras keys. Si aparece, bórrala antes de mandar.
Reencuadre
Cada error resuelto es una cosa que ya no te va a frenar. Coleccionarlos es, literalmente, aprender a construir.
¿Ya sabes cuál es? → Errores comunes y su solución.