SuperDevTools

Générateur de fichier .gitignore

Rien n'est envoyé : le fichier est assemblé dans votre navigateur. Votre sélection est retenue sur cet appareil.

Un fichier .gitignore prêt en quelques clics

Le fichier .gitignore, placé à la racine d'un dépôt de code, liste ce que le gestionnaire de versions doit laisser de côté : dépendances téléchargées, fichiers compilés, journaux, mots de passe du fichier .env, fichiers cachés créés par votre système ou votre éditeur. Ce générateur gitignore assemble ce fichier pour vous à partir de 49 modèles, sans ligne en double.

Rien n'est envoyé : le fichier est assemblé dans votre navigateur. Votre sélection et vos lignes personnelles sont retenues sur cet appareil pour la prochaine fois.

Mode d'emploi

  1. Dans « Rechercher un modèle », tapez un mot comme python, symfony ou log pour filtrer la liste.
  2. Cochez les modèles utiles. Ils sont rangés en quatre groupes : « Langages », « Frameworks et outils de construction », « Environnements, secrets et fichiers produits », « Fichiers système et d'éditeurs ». « Tout décocher » repart de zéro.
  3. Le contenu apparaît aussitôt dans « Fichier .gitignore », avec le nombre de modèles, de règles et de doublons retirés.
  4. Ajoutez vos propres chemins dans « Lignes personnelles (ajoutées à la fin) », un par ligne, par exemple uploads/.
  5. Décochez « Sections commentées » si vous voulez un fichier sans les titres # ….
  6. Cliquez sur « Télécharger .gitignore » ou sur « Copier ».

Certains navigateurs retirent le point au début du nom d'un fichier téléchargé. Si vous recevez un fichier nommé gitignore, renommez-le simplement en .gitignore et placez-le à la racine du projet.

Exemple : un projet Python avec Django

Cochez « Python », « Django » et « Dossiers de compilation (build, dist) ». Le modèle Python contient déjà build/ et dist/ : l'outil ne les répète pas et affiche « Modèles : 3 · règles : 21 · doublons retirés : 2 ». La section des dossiers de compilation ne garde que out/. Ajoutez ensuite « Secrets et .env » pour ne jamais publier la clé secrète ou le mot de passe de la base de données.

Pour un site PHP, la combinaison « PHP », « Symfony », « Secrets et .env » et « Dossiers d'IDE et d'éditeurs (.idea, .vscode) » couvre l'essentiel ; ajoutez « Métadonnées de dossier (.DS_Store…) » et « Miniatures et réglages de dossier (Thumbs.db…) » si l'équipe travaille sur plusieurs systèmes.

Les règles à connaître

LigneEffet
*.logtous les fichiers qui finissent par .log, dans tout le projet
logs/tout dossier nommé logs, avec son contenu
/vendor/le dossier vendor à la racine seulement
!.env.exampleexception : ce fichier reste suivi malgré .env.*
**/*.rs.bkces fichiers dans n'importe quel sous-dossier

L'ordre compte : une exception commençant par ! doit venir après la règle qu'elle corrige. Le générateur garde l'ordre des modèles et place vos lignes personnelles en dernier, pour qu'elles aient le dernier mot. Une ligne qui commence par # est un commentaire.

Le fichier .gitignore n'est pas le seul fichier caché utile à la racine d'un site : pour les redirections et le cache côté serveur, voyez le générateur htaccess, et pour guider les robots d'indexation, le générateur de robots.txt. Si votre projet contient des fichiers de configuration YAML, vous pouvez aussi valider du YAML avant de les publier.

Questions fréquentes

J'ai ajouté une règle, mais le fichier est toujours suivi. Pourquoi ?

Le .gitignore ne concerne que les fichiers pas encore suivis. Pour un fichier déjà enregistré dans le dépôt, retirez-le de l'index avec git rm --cached chemin/du/fichier (il reste sur votre disque), puis validez la modification.

Faut-il ignorer le fichier de verrouillage des dépendances ?

Non, en général. Les fichiers comme composer.lock ou package-lock.json fixent les versions exactes : gardez-les suivis dans une application. Aucun modèle de l'outil ne les ignore. Seul le modèle Dart ignore pubspec.lock, comme c'est l'usage pour une bibliothèque.

Mes mots de passe ont déjà été publiés. Le .gitignore suffit-il ?

Non. Ignorer le fichier .env empêche les prochaines fuites, mais l'historique garde l'ancienne version. Changez immédiatement les mots de passe et les clés concernés.

Puis-je avoir plusieurs fichiers .gitignore ?

Oui. Chaque dossier peut avoir le sien ; ses règles s'appliquent à ce dossier et à ses sous-dossiers. Un seul fichier à la racine reste toutefois le plus simple à relire.