Programación

Qué es .gitignore y cómo evitar que Git suba archivos que no quieres

Un archivo con patrones que dice qué no debe rastrear Git: sintaxis, dónde se guarda y cómo dejar de seguir un archivo ya subido.

Enviar por WhatsApp

Un archivo .gitignore le dice a Git qué archivos y carpetas no debe rastrear: dependencias descargadas, archivos de compilación, registros, claves o ajustes de tu editor. Sin él, un git add . acaba subiendo cosas que no deberían estar en el repositorio. Esta guía resume lo que dice la documentación oficial de Git.

Dónde poner cada patrón, según la documentación de Git.En .gitignore: Para ignorar archivos generados por el proyecto; Se versiona y se comparte al clonar. En .git/info/exclude o core.excludesFile: Para preferencias solo tuyas; No se comparte con el repositorioCOMPARATIVAEn .gitignorePara ignorar archivos generadospor el proyectoSe versiona y se comparte alclonarEn .git/info/exclude ocore.excludesFilePara preferencias solo tuyasNo se comparte con el repositorio
Dónde poner cada patrón, según la documentación de Git.

Qué hace exactamente

Según la documentación, un archivo gitignore especifica archivos intencionadamente sin rastrear que Git debe ignorar. Cada línea es un patrón. Ojo con una limitación importante: los archivos que Git ya rastrea no se ven afectados (hay una solución más abajo).

Dónde se puede poner

Git mira varios sitios, y según el patrón conviene uno u otro:

  • Un archivo .gitignore en el proyecto: para patrones que deben compartirse con todo el mundo al clonar el repositorio, normalmente los archivos que genera el propio proyecto al compilarlo. Puede haber varios .gitignore en carpetas distintas: los de las carpetas más internas tienen prioridad sobre los de las superiores.
  • $GIT_COMMON_DIR/info/exclude (en la práctica, .git/info/exclude): para patrones específicos de ese repositorio que no hace falta compartir, como archivos auxiliares de tu forma de trabajar.
  • El archivo indicado por core.excludesFile en tu ~/.gitconfig: para lo que quieres que Git ignore siempre, en todos tus proyectos, como los temporales de tu editor.
Ejemplo de archivo .gitignore.# Dependencias y compilados | node_modules/ | *.log | !importante.logEN LA TERMINAL.gitignore# Dependencias y compiladosnode_modules/*.log!importante.log
Ejemplo de archivo .gitignore.

Formato de los patrones

La documentación detalla las reglas principales:

  • Una línea en blanco no coincide con nada, y sirve para separar.
  • Una línea que empieza por # es un comentario.
  • Un prefijo ! niega el patrón: cualquier archivo excluido antes vuelve a incluirse. Pero no se puede reincluir un archivo si su carpeta superior está excluida.
  • La barra / separa directorios. Si hay una barra al final, el patrón solo coincide con carpetas; por ejemplo frotz/ coincide con la carpeta frotz o a/frotz.
  • Un asterisco * coincide con cualquier cosa excepto la barra, y ? con un solo carácter (salvo /). También sirven rangos como [a-zA-Z].
  • Dos asteriscos seguidos (**) tienen significado especial: **/foo coincide con foo en cualquier carpeta, abc/** coincide con todo lo que hay dentro de abc, y a/**/b coincide con a/b, a/x/b, a/x/y/b, etc.
  • Una barra invertida \ escapa un carácter.

Si un patrón tiene una barra al principio o en medio, es relativo a la carpeta donde está el .gitignore; si no la tiene, puede coincidir en cualquier nivel por debajo. Como ejemplo de la documentación, hello.* coincide con cualquier archivo o carpeta cuyo nombre empiece por hello..

Qué hacer si ya subiste algo

Es el error más común: añades secretos.env al .gitignore, pero Git sigue rastreándolo porque ya estaba en el repositorio. La documentación lo resuelve: para dejar de rastrear un archivo, usa git rm --cached para sacarlo del índice, y luego añade su nombre al .gitignore para que no vuelva a entrar en futuros commits. El archivo sigue existiendo en tu carpeta.

Esto solo evita que se suba a partir de ahora: si el archivo contenía una contraseña o una clave y ya llegó a un repositorio público, debes cambiarla, porque sigue en el historial. Para deshacer otros cambios sin perder trabajo, mira deshacer cambios en Git.

Si el archivo ya estaba rastreado.1. git rm --cached archivo 2. Añade el nombre a .gitignore 3. Haz commit del cambio 4. Git deja de incluirlo en futuros commitsPASO A PASO1PASO 1git rm--cachedarchivo2PASO 2Añade elnombre a.gitignore3PASO 3Haz commitdel cambio4FINALGit deja deincluirlo enfuturoscommits
Si el archivo ya estaba rastreado.

Para empezar

Si no sabes aún cómo funciona Git, empieza por Git y GitHub: primeros pasos y por la terminal y sus comandos básicos. Para probar patrones con comodines, puede ayudarte el probador de expresiones regulares, aunque los patrones de gitignore no son expresiones regulares.