Git add – Agregar archivos al área de preparación

El comando git add es fundamental para preparar los cambios antes de crear un commit. En esta guía aprenderás qué es, para qué sirve y cómo utilizarlo correctamente para agregar archivos al área de preparación con ejemplos prácticos y paso a paso.

1. ¿Qué es y para qué sirve git add?

El comando git add se utiliza para agregar archivos al área de preparación (Staging Area) antes de crear un commit. En otras palabras, le indica a Git qué cambios deseas incluir en la próxima versión del proyecto.

Es importante entender que Git no guarda automáticamente todos los cambios que realizas en tus archivos. Primero debes seleccionarlos con git add y, una vez preparados, podrás registrarlos definitivamente mediante un commit.

2. ¿Cómo funciona?

Cuando modificas un archivo, Git detecta el cambio, pero este todavía no forma parte del historial del proyecto.

El flujo de trabajo es el siguiente:

Modificar un archivo
        │
        ▼
Git detecta el cambio
        │
        ▼
git add
        │
        ▼
Área de preparación (Staging Area)
        │
        ▼
git commit
        │
        ▼
Historial del repositorio

Como puedes ver, git add actúa como un paso intermedio entre modificar un archivo y guardar esos cambios de forma permanente en el historial del repositorio.

3. ¿Cómo utilizar git add?

Git permite agregar archivos de diferentes maneras según lo que necesites.

3.1. Agregar un archivo específico

Si solo deseas preparar un archivo, utiliza:

git add index.htmlLenguaje del código: CSS (css)

En este caso, únicamente index.html pasará al área de preparación.

3.2. Agregar varios archivos

También puedes agregar varios archivos al mismo tiempo:

git add index.html estilos.css app.jsLenguaje del código: CSS (css)

Todos esos archivos quedarán listos para el próximo commit.

3.3. Agregar todos los archivos modificados

Si quieres preparar todos los archivos nuevos y modificados del proyecto, utiliza:

git add .

Este es uno de los comandos más utilizados, ya que agrega todos los cambios del directorio actual.

4. ¿Cómo comprobar que los archivos fueron agregados?

Después de ejecutar git add, puedes utilizar el siguiente comando:

git status

Git mostrará qué archivos se encuentran en el área de preparación y cuáles todavía no han sido agregados.

5. ¿Por qué es importante git add?

Utilizar git add ofrece varias ventajas:

• Permite seleccionar exactamente qué cambios incluir en un commit.
• Evita guardar modificaciones que todavía no están terminadas.
• Facilita la creación de commits más organizados.
• Ayuda a mantener un historial de cambios claro y fácil de entender.
• Forma parte del flujo de trabajo fundamental de Git.

6. Ejemplo de casos reales donde se utiliza

En proyectos reales es muy común modificar varios archivos durante una misma jornada de trabajo. Sin embargo, no siempre conviene guardar todos esos cambios en un único commit. Gracias a git add, puedes seleccionar únicamente los archivos que deseas incluir en la próxima versión del proyecto.

A continuación, veremos algunos ejemplos prácticos.

Ejemplo 1. Agregar una nueva funcionalidad

Supongamos que estás desarrollando una página web y agregas un formulario de contacto.

Has modificado estos archivos:

📄 index.html
📄 estilos.css
📄 app.jsLenguaje del código: CSS (css)

Como todos los cambios pertenecen a la misma funcionalidad, puedes agregarlos juntos:

git add index.html estilos.css app.jsLenguaje del código: CSS (css)

Luego realizas un único commit describiendo la nueva característica.

¿Por qué es beneficioso?

Porque todo el código relacionado con el formulario queda agrupado en un mismo commit, facilitando el seguimiento del historial.

Ejemplo 2. Guardar solo una parte del trabajo

Imagina que durante el día realizaste dos tareas diferentes:

• Corregiste un error en app.js.
• Empezaste a crear una nueva página en index.html, pero todavía no la terminaste.

En este caso solo quieres guardar la corrección del error.

git add app.jsLenguaje del código: CSS (css)

Después haces el commit correspondiente.

La nueva página permanecerá sin preparar hasta que esté terminada.

¿Por qué es beneficioso?

Porque cada commit representa una única tarea o cambio específico, haciendo que el historial sea mucho más claro y fácil de entender.

Ejemplo 3. Trabajar en equipo

Supongamos que otro desarrollador necesita revisar la corrección de un error urgente.

Durante ese mismo día también realizaste otros cambios que aún no están listos.

Con git add puedes preparar únicamente el archivo corregido:

git add login.jsLenguaje del código: CSS (css)

Luego envías ese commit para que el equipo pueda revisarlo.

¿Por qué es beneficioso?

Evitas compartir código incompleto o en desarrollo y facilitas el proceso de revisión.

Ejemplo 4. Actualizar únicamente un archivo

Imagina que detectas un error ortográfico en el archivo README.md.

Solo modificas ese archivo:

git add README.mdLenguaje del código: CSS (css)

Después realizas un commit con un mensaje como:

Corregir errores ortográficos del README

¿Por qué es beneficioso?

El historial queda organizado y resulta sencillo identificar cuándo se realizaron cambios en la documentación.

Ejemplo 5. Preparar todo el proyecto

Después de terminar una nueva versión de tu aplicación, todos los cambios están listos.

Puedes agregarlos de una sola vez:

git add .

Luego creas el commit.

¿Por qué es beneficioso?

Es una forma rápida de preparar todos los archivos modificados cuando estás seguro de que todos deben formar parte de la siguiente versión del proyecto.

Ejemplo 6. Evitar guardar archivos innecesarios

Supongamos que modificaste estos archivos:

📄 index.html
📄 estilos.css
📄 app.js
📄 notas.txtLenguaje del código: CSS (css)

El archivo notas.txt contiene apuntes personales y no deseas incluirlo en el repositorio.

En lugar de ejecutar:

git add .

puedes hacer:

git add index.html estilos.css app.jsLenguaje del código: CSS (css)

¿Por qué es beneficioso?

Evitas agregar archivos temporales, notas personales o información que no debería formar parte del historial del proyecto.

¿Qué tienen en común todos estos ejemplos?

En todos los casos, git add cumple la misma función: seleccionar los cambios que formarán parte del próximo commit. Esto permite crear un historial de versiones más limpio, organizado y fácil de comprender, especialmente en proyectos grandes o cuando se trabaja en equipo.

BUENA PRÁCTICA: Antes de ejecutar git add, revisa los cambios con git status. Después, agrega únicamente los archivos relacionados con una misma tarea o funcionalidad. De esta forma, cada commit tendrá un propósito claro y el historial de tu proyecto será mucho más profesional.