Errores
Resolución de problemas
Los errores son una parte normal de la programación, no una señal de que «no se te da bien». Los desarrolladores con experiencia ven mensajes de error todos los días; la diferencia es que saben dónde mirar. La mayoría de las veces la causa es sencilla: una errata, la carpeta equivocada, otra versión del lenguaje, un cambio sin guardar en un commit. En esta sección encontrarás respuestas a situaciones típicas del principiante y el orden en que conviene buscar la causa.
Un mensaje de error no es una sentencia, sino una nota del programa sobre el punto en que se ha perdido.
Cómo está organizada la sección: describimos los primeros pasos de forma general, sin depender de editores ni sistemas operativos concretos. Busca los comandos exactos y los nombres de las opciones en la documentación oficial de tu lenguaje y tus herramientas.
Si algo no funciona
La terminal dice que no encuentra el comando
Lo más probable es que el programa no esté instalado o que la terminal no sepa dónde está. Comprueba que la instalación terminó, reinicia la terminal y mira si la ruta del programa figura en la configuración del sistema. A veces el comando se llama de forma algo distinta a lo que esperas: compruébalo en la documentación.
El programa informa de un error de sintaxis
El intérprete no ha podido analizar el texto del programa. Mira la línea que indica y la anterior: a menudo el culpable es un paréntesis o unas comillas sin cerrar, un signo de puntuación que falta o una sangría de más o de menos.
El programa se ejecuta, pero no muestra nada
Comprueba si realmente se llama a la parte del código que necesitas y si guardaste el archivo antes de ejecutarlo. Añade mensajes temporales en pantalla en varios puntos para ver hasta dónde llega la ejecución y luego elimínalos.
A otros les funciona y a mí no
Compara las versiones del lenguaje y de las bibliotecas instaladas, el sistema operativo y la carpeta desde la que ejecutas el programa. A menudo el problema está en un archivo de configuración o en una dependencia que no tienes. Ayuda mucho tener en el proyecto una lista de dependencias con sus números de versión.
Hay un conflicto al fusionar en el repositorio
Un conflicto significa que las mismas líneas se modificaron en dos sitios y el sistema no sabe qué versión conservar. Abre el archivo, busca las zonas marcadas, elige la variante correcta o combina ambas, borra las marcas de control y haz un commit con el resultado.
Han desaparecido cambios que había hecho
No te asustes y no borres nada todavía. Si los cambios estaban en un commit, puedes encontrarlos en el historial del repositorio. Si no, comprueba que no tengas abierto otro archivo u otra rama y revisa el historial de cambios del editor. En adelante, haz commits con más frecuencia.
Cómo buscar la causa de un error
Lee el mensaje completo
No cierres enseguida la ventana del error. Busca el tipo de error, el archivo y el número de línea, y apunta la frase clave.
Reproduce el error
Asegúrate de que el error se repite en cada ejecución y anota qué acciones lo provocan.
Si el fallo solo ocurre con ciertos datos de entrada, guárdalos: serán tu primera prueba.
Recuerda el último cambio
Lo que más se rompe es lo último que se tocó. Compara la versión actual del archivo con la que tienes guardada en el repositorio.
Reduce el ejemplo
Quita partes del código una a una hasta que el error desaparezca. El último fragmento que quitaste es el principal sospechoso.
Busca el texto del error
Busca el mensaje sin tus nombres de archivos y variables: seguro que alguien ya se ha topado con los errores habituales. Consulta también la documentación oficial.
Pregunta y anota la respuesta
Si nada funciona, pregunta a la comunidad siguiendo la plantilla de la sección de guías. Cuando encuentres la causa, anótala en tu diario de errores.
Secciones relacionadas
- Guías
Guías paso a paso: entorno, primer script, primer repositorio, mensajes de error y preguntas a la comunidad. Aquí está también el catálogo de artículos.
- Herramientas
El kit del principiante sin marcas: editor de código, terminal, intérprete o compilador, control de versiones, alojamiento de repositorios y gestor de paquetes.
- Preguntas
Respuestas sobre la guía, sobre aprender a programar desde cero y sobre los primeros proyectos en la práctica.
Fuentes
- Git documentation
- Python documentation
Las fechas y definiciones proceden de la documentación oficial y las especificaciones vigentes en la fecha de elaboración. Los lenguajes y las herramientas evolucionan, así que confirma los detalles en las fuentes originales actualizadas.