Qué incluir en un archivo .gitignore
Empieza por lo que puedes volver a generar: dependencias instaladas, resultados de compilación y cachés. Para Next.js, combina su plantilla con Node.js. En proyectos Java, elige Maven o Gradle según el sistema de compilación que uses.
Las 18 plantillas integradas sirven como punto de partida. No analizan tu repositorio ni reproducen toda la colección de GitHub. Descarga el archivo con el nombre .gitignore, incluido el punto inicial, y combina las reglas con las existentes antes de hacer commit.
Reglas del equipo y exclusiones personales
Una configuración compartida del editor puede ser tan importante como el código. Por eso las plantillas de VS Code y JetBrains solo excluyen determinados datos personales, y no todos los ajustes. Para archivos exclusivamente locales puedes utilizar .git/info/exclude.
Los archivos de bloqueo habituales se conservan. Decide con el equipo si corresponde versionarlos según el ecosistema y si se trata de una aplicación o una biblioteca. No hace falta excluir todos los archivos lock para mantener limpio el repositorio.
Ejemplos para tres entornos
Proyecto Next.js
Dependencias Node.js, salida de Next.js y metadatos macOS; conserva los archivos de bloqueo.
Volver al generador ↑# Creado con el generador Gitignore de LightNode
# Revisa estas reglas básicas antes de añadirlas al proyecto.
# Node.js
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-store/
coverage/
.nyc_output/
# Next.js
.next/
out/
.vercel/
*.tsbuildinfo
# macOS
.DS_Store
._*
.Spotlight-V100/
.Trashes/
Entorno Python
Entornos y cachés de Python, historial VS Code y copias de seguridad Linux.
Volver al generador ↑# Creado con el generador Gitignore de LightNode
# Revisa estas reglas básicas antes de añadirlas al proyecto.
# Python
__pycache__/
*.py[cod]
.venv/
venv/
.pytest_cache/
.mypy_cache/
.ruff_cache/
.coverage
htmlcov/
*.egg-info/
# VS Code
.history/
*.vsix
# Linux
.Trash-*/
*~
Java con IntelliJ
Maven y Gradle junto a datos personales de JetBrains y metadatos Windows. Quita el sistema de compilación que no uses.
Volver al generador ↑# Creado con el generador Gitignore de LightNode
# Revisa estas reglas básicas antes de añadirlas al proyecto.
# Java / Maven
*.class
target/
# Gradle
.gradle/
build/
# JetBrains
.idea/workspace.xml
.idea/tasks.xml
.idea/shelf/
.idea/httpRequests/
# Windows
Thumbs.db
ehthumbs.db
Desktop.ini
$RECYCLE.BIN/
Dudas al configurar .gitignore
¿Por qué .gitignore no funciona con un archivo ya subido?
Git sigue rastreando los archivos que ya conoce. Comprueba las reglas con git check-ignore -v --no-index path/to/file. Si decides dejar de rastrearlo, git rm --cached -- path/to/file prepara su eliminación del repositorio, pero conserva la copia local. Revisa el cambio antes del commit.
¿Cómo dejo una excepción dentro de una carpeta?
Escribe /logs/* y después !/logs/keep.log. Si excluyes la carpeta padre con /logs/, no podrás volver a incluir archivos que estén dentro.
¿Se ordenan o eliminan reglas duplicadas?
No. A igual prioridad, gana la última regla que coincida. Las plantillas mantienen un orden fijo y las reglas propias se añaden al final. Cambiar la combinación conserva tu texto; Borrar todo elimina tanto las plantillas como el texto.
¿Puedo mantener .env.example?
Sí. La plantilla opcional excluye .env y .env.*, pero mantiene .env.example y .env.sample. Usa solo valores ficticios en esos ejemplos: estas reglas no borran secretos de commits anteriores.
¿Se guardan o envían mis reglas?
Se generan en el navegador, sin subir repositorios ni llamar a una API de generación. Las reglas propias no se guardan de forma persistente ni se añaden a la URL. Copiar y descargar exportan el texto cuando lo solicitas.