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.
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.
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
.gitignoreen 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.gitignoreen 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.excludesFileen tu~/.gitconfig: para lo que quieres que Git ignore siempre, en todos tus proyectos, como los temporales de tu editor.
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 ejemplofrotz/coincide con la carpetafrotzoa/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:**/foocoincide confooen cualquier carpeta,abc/**coincide con todo lo que hay dentro deabc, ya/**/bcoincide cona/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.
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.
Fuentes consultadas
- gitignore - Specifies intentionally untracked files to ignore (Git (documentación oficial))
Guía de PortalTec: https://www.portaltec.eu/articulos/gitignore-que-es-como-usarlo/
