Cuando trabajamos en un proyecto, el directorio de código se llena de archivos que no forman parte del código fuente. Estos archivos se generan automáticamente o se crean bajo demanda y, en general, no deberían ser incluidos en el repositorio. En esta lección, aprenderás a ignorar estos archivos usando Git.
Tipos de archivos que no deben estar en el repositorio
Para organizar mejor nuestro proyecto, podemos clasificar estos archivos en tres categorías:
| Categoría | Ejemplo de Archivos | Descripción |
|---|---|---|
| Herramientas | .DS_Store, .idea/, .vscode/ | Archivos creados por el sistema operativo o el editor de código. |
| Archivos Temporales | log.txt, cache/, tmp/ | Archivos generados durante la ejecución del programa o usados para acelerar procesos. |
| Artefactos | node_modules/, vendor/, dist/, coverage/ | Archivos generados por la compilación o pruebas del proyecto. |
En una situación normal, estos archivos no deben estar en el repositorio porque:
❌ Cambian constantemente, lo que hace difícil leer el historial de cambios.
❌ Pueden ser generados automáticamente, evitando la necesidad de almacenarlos.
❌ Aumentan innecesariamente el tamaño del repositorio, haciendo más lento el trabajo en equipo.
¿Cómo ignorar archivos en Git?
Git nos permite ignorar archivos y directorios usando el archivo .gitignore. Para usarlo, sigue estos pasos:
.gitignore en la raíz de tu proyecto
touch .gitignore
.gitignore para incluir las reglas necesarias
# Puedes agregar comentarios con "#"
# Ignorar archivos específicos
access.log
# Ignorar directorios completos
node_modules/
# Ignorar un directorio específico en la raíz del proyecto
/coverage/
# Ignorar archivos de una extensión en una carpeta específica
/db/*.sqlite3
# Ignorar todos los archivos .txt dentro de "doc/", en cualquier subdirectorio
doc/**/*.txt
.gitignore
git add .gitignore
git commit -m 'Añadir archivo .gitignore'
Ahora, cualquier archivo que coincida con las reglas de .gitignore será automáticamente excluido cuando revisemos el estado del repositorio con git status.
❓ ¿Qué pasa si un archivo ya fue agregado al repositorio?
Si accidentalmente agregaste un archivo al repositorio antes de ponerlo en .gitignore, simplemente agregarlo al archivo no lo eliminará. Para corregir esto, sigue estos pasos:
- Elimina el archivo del seguimiento de Git:
bash git rm --cached archivo_no_deseado.txt - Confirma los cambios:
bash git commit -m "Eliminar archivo innecesario"
Ahora el archivo sigue existiendo en tu máquina, pero no estará en Git.
Resumen
- Algunos archivos como logs, cachés y dependencias no deberían estar en el repositorio.
- Para ignorarlos, usa el archivo
.gitignoreen la raíz del proyecto. - Agrega reglas específicas en
.gitignorepara definir qué archivos o directorios excluir. - Si un archivo ya fue agregado por error, elimínalo con
git rm --cachedantes de ignorarlo. - Usar
.gitignorecorrectamente mantiene el repositorio limpio y más fácil de gestionar.
Trabajo independiente
Ignora archivos con .gitignore
1️⃣ Crea un archivo llamado .gitignore.
2️⃣ Dentro de ese archivo, escribe:
INFO.md
3️⃣ Elimina INFO.md del control de versiones (pero no lo borres de tu carpeta):
git rm --cached INFO.md git commit -m "Ignorar archivo INFO.md"
4️⃣ Asegúrate de que Git ya no lo muestra cuando haces git status. ✅
Materiales adicionales
- Colección de gitignore útiles para todas las situaciones.
- Instrucciones de Atlassian sobre gitignore.
Para acceder completo a curso necesitas un plan básico
El plan básico te dará acceso completo a todos los cursos, ejercicios y lecciones de Códica, proyectos y acceso de por vida a la teoría de las lecciones completadas. La suscripción se puede cancelar en cualquier momento.
