Les règles sont fusionnées en un seul fichier avec un titre pour chaque partie, et tout ce qui est listé deux fois n'est gardé qu'une fois. Choisissez vos langages, outils et éditeurs, ajoutez vos propres règles, et copiez un .gitignore prêt à l'emploi. C'est gratuit et cela s'exécute dans votre navigateur.
Comment créer un .gitignore
- Utilisez Rechercher des modèles pour trouver votre langage, framework, éditeur ou système d'exploitation, et cochez chacun de ceux qui s'appliquent.
- Ajoutez tout ce qui est particulier sous Vos propres règles.
- Lisez le .gitignore combiné et appuyez sur Copier, ou Effacer pour recommencer.
- Enregistrez-le dans un fichier nommé .gitignore dans le dossier racine de votre projet.
D'où viennent les règles
Les modèles suivent les listes communautaires largement utilisées pour chaque langage et outil, allégées des lignes rarement utiles. Les sorties de build, dossiers de dépendances, caches, journaux, réglages d'éditeur et fatras du système comme .DS_Store et Thumbs.db sont couverts, et les lignes commençant par ! gardent les fichiers que vous voulez généralement, comme le wrapper Gradle ou les réglages partagés de VS Code.
Garder les secrets hors de Git
Ajoutez Fichiers d'environnement et secrets pour ignorer les fichiers .env, clés privées et fichiers d'identifiants tout en gardant .env.example. Un .gitignore empêche seulement l'ajout de nouveaux fichiers. Si un secret a déjà été commité, retirez-le avec git rm --cached, puis renouvelez la clé, car elle reste dans l'historique.
Utiliser le fichier
Enregistrez-le sous .gitignore dans le dossier racine de votre dépôt, à côté du dossier .git. Les motifs terminés par / correspondent à des dossiers, un / initial ancre un motif à la racine du dépôt, ** correspond à n'importe quelle profondeur, et les règles suivantes l'emportent sur les précédentes. Exécutez git status --ignored pour vérifier ce qui est ignoré.
Conseils
- Créez le .gitignore avant le premier commit. C'est bien plus difficile à nettoyer ensuite.
- Ignorez les fichiers générés, comme les dossiers de build et de dépendances, pas votre code source.
- Commitez un .env.example pour que les autres sachent quels réglages sont nécessaires. Le générateur de .env.example peut en créer un.
- Si un fichier est déjà suivi, l'ajouter au .gitignore ne le fera pas cesser d'être suivi. Utilisez d'abord
git rm --cached.
Qui l'utilise
Développeurs qui démarrent un projet, étudiants qui rendent du code, et freelances qui remettent un dépôt à un client. Des sections sont incluses pour de nombreux langages, éditeurs et systèmes d'exploitation.
Questions
Où va le fichier .gitignore ?
Dans le dossier racine de votre dépôt, à côté du dossier .git.
Pourquoi un fichier est-il toujours suivi ?
Les règles d'exclusion n'affectent pas les fichiers déjà suivis. Retirez-les du suivi avec git rm --cached.
Quelque chose est-il envoyé ?
Non. Le fichier est créé dans votre navigateur.