Cada proyecto Node.js necesita un archivo .gitignore. Sin uno, acabarás haciendo commit de node_modules (miles de archivos), variables de entorno con claves API, artefactos de compilación y archivos de configuración del editor que no pertenecen al control de versiones.
Esta plantilla usa las reglas oficiales de gitignore de GitHub para Node.js y añade reglas comúnmente necesarias para VS Code, macOS, Windows y Linux. Cubre flujos de trabajo de npm, yarn y pnpm de serie.
Cómo usar
1. Revisa las plantillas preseleccionadas abajo (Node.js + VS Code + archivos de SO)
2. Añade o quita plantillas para que coincidan con tu proyecto
3. Haz clic en "Copiar" o "Descargar" para obtener el archivo
4. Colócalo en el directorio raíz de tu proyecto antes de tu primer commit
Preguntas frecuentes
¿Debo hacer commit de node_modules?
No. El directorio node_modules puede contener cientos de megabytes de archivos y miles de paquetes. Siempre debería estar en .gitignore. Usa 'npm install' o 'yarn install' para recrearlo desde package.json y el archivo lock.
¿Debo hacer commit de package-lock.json o yarn.lock?
Sí. Los archivos lock aseguran que todos en tu equipo obtengan exactamente las mismas versiones de dependencias. Siempre haz commit de tu archivo lock (package-lock.json, yarn.lock, o pnpm-lock.yaml) pero no de node_modules en sí.
¿Debo ignorar archivos .env?
Sí. Los archivos de entorno (.env, .env.local) a menudo contienen claves API, credenciales de base de datos y otros secretos. Añade .env* a tu .gitignore. Usa .env.example (con commit) para documentar qué variables son necesarias.