2.2 Haciendo tu primer commit

Llegó el momento de la verdad: vamos a hacer que Git guarde nuestro trabajo de forma permanente en el historial.

De la mesa de trabajo a la caja (Staging)

Siguiendo nuestra analogía, tienes tu archivo modificado en el taller. Para moverlo al área de preparación, usamos git add.

git add index.html

Si tienes múltiples archivos y estás seguro de querer prepararlos todos (asumiendo que tu .gitignore está bien configurado), puedes usar el punto para añadir todo el directorio:

git add .

Inspeccionando antes de empacar: git diff

Una buena práctica antes de añadir archivos, o antes de sellarlos definitivamente, es revisar qué cambió exactamente línea por línea. Aquí entra el comando git diff.

Si ejecutas git diff, verás las líneas eliminadas en rojo y las nuevas en verde para todo lo que aún está en el Working Directory. Pero si ya hiciste git add y los archivos están en la caja de preparación, necesitas usar git diff --staged para ver exactamente qué vas a guardar en el próximo commit.

Sellando la caja: El Commit

Con nuestros archivos listos en el Staging Area, tomamos la instantánea definitiva. A esto se le llama hacer un "commit". Cada commit requiere obligatoriamente un mensaje.

git commit -m "feat: añade página de inicio"

Mejores prácticas para mensajes (Conventional Commits)

El error de principiante más común no es técnico, es de comunicación. Mensajes como "arreglos", "cambios varios" o "ahora sí funciona" son pesadillas para el trabajo en equipo.

En la industria moderna se ha adoptado una convención llamada Conventional Commits, que sugiere agregar un prefijo al mensaje para identificar su propósito. Algunos ejemplos comunes:

• feat: Para una nueva característica (`feat: agrega formulario de contacto`)
• fix: Para resolver un error (`fix: corrige cálculo del IVA`)
• docs: Cambios en la documentación (`docs: actualiza el archivo readme`)
• refactor: Mejoras en código que no alteran la funcionalidad final

Adoptar esta práctica desde el primer día te hará destacar como un desarrollador profesional, ya que facilita a todos la lectura del historial del proyecto.

Puntos clave

• git add prepara tus archivos llevándolos al Staging Area.
• Usa git diff (o --staged) para verificar tus cambios con precisión quirúrgica antes de guardar.
• git commit sella el historial permanentemente.
• Escribir mensajes claros usando convenciones como "feat:" o "fix:" es el sello de identidad de un profesional.