Introducción a Git

Teoría: Ignorar archivos

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íaEjemplo de ArchivosDescripción
Herramientas.DS_Store, .idea/, .vscode/Archivos creados por el sistema operativo o el editor de código.
Archivos Temporaleslog.txt, cache/, tmp/Archivos generados durante la ejecución del programa o usados para acelerar procesos.
Artefactosnode_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:

1️⃣ Crea un archivo .gitignore en la raíz de tu proyecto
touch .gitignore
2️⃣ Edita el archivo .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
3️⃣ Agrega y confirma los cambios en el archivo .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:

  1. Elimina el archivo del seguimiento de Git:
    git rm --cached archivo_no_deseado.txt
  2. Confirma los cambios:
    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 .gitignore en la raíz del proyecto.
  • Agrega reglas específicas en .gitignore para definir qué archivos o directorios excluir.
  • Si un archivo ya fue agregado por error, elimínalo con git rm --cached antes de ignorarlo.
  • Usar .gitignore correctamente mantiene el repositorio limpio y más fácil de gestionar.

Completado

0 / 15