Aprender Git: el tutorial completo para principiantes

Git es un sistema de control de versiones distribuido. Guarda el estado de tus archivos en cada etapa del trabajo, te permite volver atrás y hace posible que varias personas trabajen en el mismo proyecto sin pisarse unas a otras. Es la herramienta básica del oficio de desarrollador: se usa tanto para un script de cien líneas como para el kernel de Linux.

Git no es GitHub

Es la confusión más habitual cuando se empieza. Git es un programa que se ejecuta en tu máquina y que gestiona el historial de tu proyecto dentro de una carpeta oculta .git. Funciona sin conexión a internet y sin cuenta en ningún sitio.

GitHub, GitLab o Bitbucket son proveedores de alojamiento de repositorios Git. Guardan una copia de tu proyecto en sus servidores, sirven de punto de encuentro para un equipo y añaden sus propias herramientas alrededor de Git: gestión de incidencias, revisión de código, integración continua. Puedes usar Git toda tu vida sin crear jamás una cuenta de GitHub. Al revés no tiene sentido.

En este tutorial, Git es la herramienta que aprendes. GitHub y GitLab son los servicios que usas para compartir tu trabajo.

Lo que sabrás hacer al terminar

• Instalar Git y configurarlo bien a la primera, incluida la autenticación por clave SSH.
• Crear un repositorio en GitHub o GitLab y conectarlo con una carpeta de tu máquina, en los dos sentidos.
• Guardar tu trabajo en etapas legibles, consultar el historial y deshacer un error sin perderlo todo.
• Trabajar en una rama, fusionarla y resolver un conflicto a mano.
• Elegir el modelo de ramas que le conviene a tu equipo, entre Gitflow y el trunk-based development.

Lo que necesitas

Una terminal y nada más. Este tutorial no usa ninguna interfaz gráfica: ni GitHub Desktop, ni la pestaña Git de tu editor. Esas herramientas son cómodas una vez que entiendes lo que hacen por ti, y engañosas antes. Todos los comandos funcionan igual en Windows (desde Git Bash), macOS y Linux.

No hace falta ningún conocimiento previo, pero saber moverte por una terminal con cd y ls ayuda mucho.

Una nota sobre las versiones

Git es un software estable y lento en cambiar: los comandos de este tutorial funcionan desde hace años y seguirán funcionando. Aun así, hay dos puntos que se mueven y que se tratan explícitamente en los capítulos correspondientes.

Primero, los comandos git switch y git restore, aparecidos con Git 2.23 en 2019, que sustituyen con ventaja a git checkout para cambiar de rama y descartar modificaciones. La documentación oficial ya no los marca como experimentales. Este tutorial los enseña primero, y da el equivalente con git checkout para que puedas leer el código de los demás.

Después, el nombre de la rama por defecto. Al contrario de lo que suele creerse, git init sigue creando una rama master en Git 2.55, no main. El cambio está anunciado para Git 3.0. El primer capítulo te enseña a resolver este punto de una vez por todas.

El recorrido

1. Instalar y configurar Git, instalación según el sistema, identidad, rama por defecto y autenticación por clave SSH o token.
2. Crear un repositorio y clonarlo en local, los dos caminos posibles: clonar un repositorio existente o publicar una carpeta que ya tienes.
3. Los comandos básicos — status, add, commit, push, pull, el archivo .gitignore y, sobre todo, cómo deshacer una metedura de pata.
4. Trabajar en equipo con ramas, crear una rama, fusionarla, resolver un conflicto y elegir entre merge y rebase.
5. Gitflow o trunk-based, los dos modelos de ramas, sus comandos y en qué contexto se justifica cada uno.

Los capítulos van seguidos: cada uno retoma el proyecto donde lo dejó el anterior. Aun así, puedes entrar directamente en el que te interese, porque los comandos necesarios se recuerdan allí.

Este tutorial forma parte del recorrido Desarrollo web de Gekkode.