.gitignore
Un archivo de texto con la lista de cosas que Git debe ignorar: no las versiona ni las sube nunca.
✦Apagada: responde bien la pregunta del final para encenderla
También lo verás como: .gitignore · ignorar archivos · archivos ignorados
Analogía
La lista de "esto no se mete en la maleta".
Qué va siempre ahí
| Qué | Por qué |
|---|---|
.env, .env.local |
secretos: claves de bases de datos, de pagos… |
node_modules/ |
librerías descargables: se reinstalan con un comando (Fase 5) |
.next/, dist/, build/ |
archivos generados automáticamente |
.DS_Store, .obsidian/workspace.json |
basura del sistema o del editor |
Ejemplo
.env
.env.local
node_modules/
.next/
.DS_Store
⚠️ El aviso más importante
Si un secreto ya se subió en un commit, añadirlo después al .gitignore no lo borra del historial. Hay que darlo por comprometido y cambiarlo (generar una clave nueva). Por eso el .gitignore se revisa antes del primer commit, no después (Fase 8).
Con IA
Los frameworks generan un .gitignore correcto al crear el proyecto. Tu trabajo es comprobar, con git status, que ningún .env aparece como archivo a subir.
Un paso más: cómo se escribe
Una línea por regla. Lo básico:
| Línea | Ignora |
|---|---|
.env |
ese archivo |
node_modules/ |
esa carpeta entera (la barra final indica carpeta) |
*.log |
todos los archivos que acaben en .log (* = "cualquier cosa") |
# comentario |
nada: las líneas con # son notas para personas |
Lo que hay que entender: .gitignore solo afecta a archivos que Git todavía no sigue. Si un archivo ya entró en un commit, añadirlo aquí no lo saca: Git lo seguirá vigilando.
Y el propio .gitignore sí se sube: forma parte del proyecto, para que todos los que lo usen ignoren lo mismo.