Chaque projet Node.js a besoin d'un fichier .gitignore. Sans lui, vous finirez par committer node_modules (des milliers de fichiers), des variables d'environnement avec des clés API, des artefacts de build et des fichiers de configuration d'éditeur qui n'ont pas leur place en contrôle de version.
Ce modèle utilise les règles gitignore Node.js officielles de GitHub et ajoute les règles couramment nécessaires pour VS Code, macOS, Windows et Linux. Il couvre les workflows npm, yarn et pnpm directement.
Comment utiliser
1. Examinez les modèles présélectionnés ci-dessous (Node.js + VS Code + fichiers OS)
2. Ajoutez ou supprimez des modèles selon votre projet
3. Cliquez sur « Copier » ou « Télécharger » pour obtenir le fichier
4. Placez-le à la racine de votre projet avant votre premier commit
Questions frequentes
Dois-je committer node_modules ?
Non. Le répertoire node_modules peut contenir des centaines de mégaoctets de fichiers et des milliers de packages. Il devrait toujours être dans .gitignore. Utilisez 'npm install' ou 'yarn install' pour le recréer à partir de package.json et du fichier lock.
Dois-je committer package-lock.json ou yarn.lock ?
Oui. Les fichiers lock garantissent que tous les membres de votre équipe obtiennent exactement les mêmes versions de dépendances. Committez toujours votre fichier lock (package-lock.json, yarn.lock ou pnpm-lock.yaml) mais pas node_modules lui-même.
Dois-je ignorer les fichiers .env ?
Oui. Les fichiers d'environnement (.env, .env.local) contiennent souvent des clés API, des identifiants de base de données et d'autres secrets. Ajoutez .env* à votre .gitignore. Utilisez .env.example (committé) pour documenter quelles variables sont nécessaires.
Quelle est la différence entre npm, yarn et pnpm ?
Ce sont trois gestionnaires de packages pour Node.js. npm est le gestionnaire par défaut inclus avec Node. yarn est une alternative créée par Facebook avec un meilleur caching. pnpm utilise des liens symboliques pour économiser de l'espace disque. Tous trois créent node_modules qui doit être ignoré.
Dois-je ignorer le dossier dist ou build ?
Oui, généralement. Ces dossiers contiennent le code compilé/bundlé qui peut être régénéré à partir des sources. Exception : si vous publiez une librairie npm, le dossier dist peut être inclus dans le package publié mais exclu du dépôt Git.
Comment gérer les fichiers de configuration ESLint et Prettier ?
Les fichiers de configuration comme .eslintrc.js et .prettierrc devraient être committés — ils assurent que toute l'équipe utilise les mêmes règles de linting et formatage. Seuls les caches générés (.eslintcache) doivent être ignorés.
Pourquoi ignorer les fichiers .DS_Store ?
Les fichiers .DS_Store sont créés par macOS pour stocker les attributs de dossier personnalisés (position des icônes, paramètres d'affichage). Ils sont spécifiques à chaque utilisateur Mac et n'ont pas leur place dans un dépôt Git partagé avec des utilisateurs Windows ou Linux.