Tutorial: crea un .gitignore para no subir archivos basura

Si alguna vez subiste una carpeta node_modules completa (con sus 40,000 archivitos) a GitHub por accidente, esto es para ti. Si no, mejor, este tutorial te evita esa vergüenza pública.

Paso 1: crea el archivo

En la raíz de tu proyecto, crea un archivo llamado exactamente .gitignore (con el punto al inicio, sin extensión).

touch .gitignore

Paso 2: dile qué ignorar

# Dependencias
node_modules/

# Archivos de entorno con datos sensibles
.env

# Archivos generados por el sistema operativo
.DS_Store

# Carpetas de build
dist/
.next/

Cada línea es un patrón: node_modules/ ignora esa carpeta completa, .env ignora ese archivo específico. Git va a fingir que esos archivos no existen para efectos de git add y git status.

Paso 3: ¿y si ya subiste esos archivos antes?

.gitignore solo funciona para archivos que Git todavía no rastrea. Si ya los subiste por accidente, necesitas quitarlos del rastreo (sin borrarlos de tu computadora):

git rm -r --cached node_modules
git commit -m "Deja de rastrear node_modules"

--cached es la palabra clave aquí: borra el archivo del repositorio de Git, pero lo deja intacto en tu disco duro. Nadie pierde nada, excepto el peso muerto de tu repositorio.

Paso 4: verifica que está funcionando

git status

Si node_modules ya no aparece en la lista de archivos nuevos o modificados, tu .gitignore está haciendo su trabajo correctamente.

¿Qué acabas de aprender?

• Para qué sirve el archivo .gitignore y cómo crearlo.
• Qué tipo de archivos deberías ignorar siempre (dependencias, archivos de entorno, builds).
• Cómo dejar de rastrear archivos que ya subiste por error con git rm --cached.