Inicio › Herramientas para desarrolladores › Generador de .gitignore

Generador de .gitignore

Elige los lenguajes, frameworks, editores y sistemas operativos que usa tu proyecto y obtén un único archivo .gitignore limpio. Las plantillas se combinan en orden, las reglas duplicadas se eliminan y puedes añadir tus propias reglas antes de copiar o descargar.

Última actualización:

1. Elige plantillas

Combinaciones rápidas:

3. Tu .gitignore

Guarda el archivo como .gitignore en la raíz de tu repositorio (algunos navegadores quitan el punto inicial al descargar, así que renómbralo si hace falta). Los archivos ya rastreados necesitan git rm --cached <file> antes de que se apliquen las nuevas reglas.

Publicidad
Publicidad

Cómo usar Generador de .gitignore

  1. Elige tu stack: haz clic en plantillas como Node, Python, Go o Unity, o usa el buscador. Las combinaciones rápidas seleccionan conjuntos habituales con un clic.
  2. Añade tu entorno: incluye los sistemas operativos (macOS, Windows, Linux) y editores (VS Code, JetBrains, Vim) que usáis tú y tu equipo.
  3. Añade reglas personalizadas en el cuadro bajo las plantillas, un patrón por línea, para archivos propios del proyecto como uploads/ o *.local.json.
  4. Revisa la vista previa: los duplicados se eliminan automáticamente y los encabezados de sección muestran de dónde viene cada regla.
  5. Copia o descarga el archivo y guárdalo como .gitignore en la raíz de tu repositorio; luego haz commit.

Chuleta de la sintaxis de patrones de .gitignore

Cada línea de un .gitignore es un patrón. Git los revisa de arriba abajo y gana el último patrón que coincide, por eso las negaciones (!) deben ir después de la regla que anulan. Los patrones son relativos a la carpeta que contiene el archivo .gitignore.

PatrónQué coincide
*.logCualquier archivo que termine en .log, en todas las carpetas
build/Cualquier directorio llamado build (una barra final solo coincide con directorios)
/buildSolo build en la misma carpeta que el .gitignore (una barra inicial ancla el patrón)
docs/*.pdfArchivos PDF directamente dentro de docs/, no en sus subcarpetas (una barra en medio también ancla el patrón)
**/tempArchivos o carpetas temp a cualquier profundidad
logs/**Todo lo que hay dentro de logs/
a/**/ba/b, a/x/b, a/x/y/b y así sucesivamente
*.py[cod]Archivos .pyc, .pyo y .pyd (clase de caracteres)
!.env.exampleVuelve a incluir un archivo que una regla anterior ignoró
\#notesUn archivo llamado literalmente #notes (escapa un # o ! inicial)
# commentUna línea de comentario, ignorada por Git

Comandos de Git útiles para las reglas de exclusión

  • git check-ignore -v path/to/file muestra qué archivo .gitignore y qué línea ignoran una ruta. Es la forma más rápida de depurar una regla.
  • git rm -r --cached . seguido de git add . vuelve a aplicar un nuevo .gitignore a archivos que ya se habían confirmado. Revisa el diff antes de hacer commit.
  • git status --ignored enumera los archivos ignorados para que confirmes que no se oculta nada importante.
  • git config --global core.excludesFile ~/.gitignore_global define un archivo de exclusión personal para los archivos basura del editor y del sistema operativo en todos tus repositorios.
  • .git/info/exclude funciona como un .gitignore que nunca se sube, útil para archivos que solo tienes tú en un clon.

Qué subir y qué ignorar

Ignora todo lo que sea generado, descargado, específico de la máquina o secreto: carpetas de dependencias (node_modules/, vendor/, .venv/), resultados de compilación (dist/, target/, bin/), cachés, logs, bases de datos locales y archivos .env con credenciales reales. Sube lo que otros desarrolladores necesitan para reproducir el proyecto: código fuente, plantillas de configuración como .env.example, ajustes de editor compartidos que acordéis y archivos de bloqueo (package-lock.json, poetry.lock, go.sum, Cargo.lock en aplicaciones). Si alguna vez se subió un secreto, ignorarlo después no basta: cambia la clave, porque sigue en el historial de Git.

Preguntas frecuentes

¿Qué es un archivo .gitignore?

Un .gitignore es un archivo de texto plano en tu repositorio Git que enumera patrones de archivos y carpetas que Git no debe rastrear, como dependencias (node_modules), resultados de compilación, logs, archivos de entorno locales y archivos basura del editor o del sistema operativo.

¿Dónde pongo el archivo .gitignore?

Guárdalo como .gitignore (con el punto inicial y sin extensión) en la carpeta raíz de tu repositorio. También puedes añadir más archivos .gitignore en subcarpetas; sus patrones se aplican en relación con esa carpeta.

¿Por qué un archivo sigue rastreado después de añadirlo a .gitignore?

Un .gitignore solo afecta a los archivos no rastreados. Si Git ya rastrea un archivo, quítalo del índice con git rm --cached <file> (o git rm -r --cached <folder>) y haz commit. El archivo sigue en el disco, pero Git deja de rastrearlo.

¿Los archivos del editor y del sistema operativo deben ir en el .gitignore del proyecto?

Muchos equipos incluyen los más comunes (.DS_Store, Thumbs.db, .vscode/, .idea/) para que nadie los suba por accidente. Otra opción es que cada desarrollador los ponga en un archivo de exclusión global configurado con git config --global core.excludesFile ~/.gitignore_global.

¿Qué significa un ! al principio de un patrón?

Un ! inicial niega un patrón y vuelve a incluir un archivo que un patrón anterior ignoró, por ejemplo .vscode/* seguido de !.vscode/settings.json. Git no puede volver a incluir un archivo si su directorio padre está ignorado.

¿Debo ignorar archivos de bloqueo como package-lock.json?

En aplicaciones, no: haz commit de package-lock.json, yarn.lock, poetry.lock, Cargo.lock y archivos de bloqueo similares para que todos instalen las mismas versiones de las dependencias. Estas plantillas no ignoran los archivos de bloqueo, salvo donde se indica como opcional.

¿Se envía mi selección a un servidor?

No. Todas las plantillas están integradas en la página y el archivo se genera en tu navegador. Tu selección solo se recuerda en el almacenamiento local de este navegador.

¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?

Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.

Herramientas relacionadas

Ver todas las de Generadores de código →