El Ciclo Básico: add, commit, status

Bienvenido a tu primera lección práctica sobre Git. En este módulo aprenderás los tres comandos fundamentales que usarás cientos de veces al día cuando trabajes con control de versiones. Dominar estos tres comandos —git status, git add y git commit— es esencial para cualquier desarrollador que quiera trabajar de forma organizada y colaborativa.

¿Qué es el ciclo básico de Git?

Git funciona con un flujo de trabajo específico que implica tres áreas principales de tu proyecto:

1. Directorio de trabajo (Working Directory): Es la carpeta donde están tus archivos normales, los que ves y editas todos los días.
2. Área de preparación (Staging Area): Es una zona intermedia donde Git coloca los cambios que quieres incluir en el próximo commit.
3. Repositorio (Repository): Es donde Git guarda permanentemente tus instantáneas de código.

git status: Conoce el estado de tu proyecto

El comando git status es tu mejor amigo. Cada vez que quieras saber qué está pasando con tus archivos, este comando te lo muestra. Es como hacer un inventario de tu proyecto en un momento dado.

git status

Al ejecutarlo, Git te mostrará información importante:

• Qué archivos han sido modificados
• Qué archivos están preparados para commitear
• Qué archivos son nuevos (sin rastrear)
• Si hay conflictos sin resolver

git add: Preparando archivos para guardar

El comando git add es el puente entre tu directorio de trabajo y el área de preparación. Piensa en él como colocar elementos en una caja antes de enviar un paquete: primero pones las cosas en la caja, y cuando estás seguro de que todo está correcto, cierras la caja (haces el commit).

Sintaxis básica

# Añadir un archivo específico
git add nombre-del-archivo.html

# Añadir todos los archivos modificados
git add .

# Añadir todos los archivos con extensión específica
git add *.css

# Añadir todos los archivos de una carpeta
git add carpeta/

# Añadir múltiples archivos específicos
git add archivo1.txt archivo2.txt archivo3.txt

El punto (.) tiene poder

El punto . en Git significa "todos los archivos modificados y nuevos en el directorio actual y subdirectorios". Sin embargo, ten cuidado: git add . no añade archivos eliminados. Para eso necesitarías git add -A que añade todos los cambios de todo el repositorio.

git commit: Guardando tu trabajo permanentemente

Un commit es como tomar una foto de tu proyecto en un momento específico. Cada commit tiene un identificador único (hash SHA-1), un mensaje descriptivo, y representa un estado completo de todos los archivos que incluiste.

# Crear un commit con mensaje
git commit -m "Agregar formulario de contacto"

# Crear un commit que incluye todos los archivos modificados
git commit -am "Actualizar estilos del header"

# Modificar el último commit (si olvidaste algo)
git commit --amend

Anatomía de un buen commit

Poniendo todo junto: El flujo completo

Ahora que conoces los tres comandos, vamos a ver cómo funcionan juntos en un escenario real:

1. Empiezas a trabajar: Editas index.html, creas contacto.html y modificas styles.css
2. Verificas el estado: Ejecutas git status y ves los tres archivos como "modificados" o "no rastreados"
3. Preparas los cambios: Usas git add index.html contacto.html para añadir solo los archivos de la nueva funcionalidad
4. Haces el commit: Ejecutas git commit -m "Agregar página de contacto"
5. Verificas de nuevo: git status ahora muestra solo styles.css pendiente

Trabajando en equipos: Por qué importa este ciclo

Cuando trabajas con otras personas en un proyecto, el ciclo de add-commit se vuelve crítico por varias razones:

• Organización: Commits pequeños y focales facilitan que otros entiendan qué cambiaste
• Reversión: Si algo sale mal, puedes revertir un commit específico sin perder todo tu trabajo
• Historial limpio: Un equipo que hace commits descriptivos tiene un historial útil para investigar problemas
• Code review: Cuando alguien revisa tu código, commits lógicos hacen la revisión más eficiente

Un equipo que domina el ciclo básico de Git tiene una base sólida para colaboraciones exitosas. Los comandos complejos vendrán después, pero sin estos fundamentos, cualquier trabajo en equipo será caótico.

Conceptos avanzados que debes conocer

# Crear archivo .gitignore
touch .gitignore

# Contenido típico de .gitignore
node_modules/
.env
*.log
dist/
.DS_Store

# Ver cambios no preparados
git diff

# Ver cambios ya preparados
git diff --staged

# Ver cambios en un archivo específico
git diff archivo.html

Errores comunes y cómo evitarlos

Resumen del flujo de trabajo

# 1. Trabajas en tu proyecto
# 2. Haces cambios en archivos

# 3. Revisas el estado actual
git status

# 4. Ves los cambios específicos
git diff

# 5. Preparas los archivos que quieres guardar
git add archivo1.html
git add archivo2.css

# 6. Verificas lo que se preparó
git diff --staged

# 7. Haces el commit con descripción clara
git commit -m "Agregar página de contacto con formulario básico"

# 8. Verificas que todo quedó limpio
git status

Próximos pasos

Ahora que dominas el ciclo básico, estás listo para aprender sobre ramas (branches) y cómo trabajar con repositorios remotos en GitHub. Cada nuevo concepto que aprendas se construirá sobre estos fundamentos, así que asegúrate de practicar hasta que el flujo de status-add-commit sea automático.