Créer et tester un .gitignore

Sélectionnez les environnements de votre projet, puis testez quelques chemins. Le comparateur couvre les motifs courants ; vérifiez les cas particuliers avec Git.

Fonctionne localement dans votre navigateur
Tout dans cet outil est traité dans ce navigateur. KivTools ne télécharge pas, ne stocke pas et n’appelle aucune API tierce avec votre entrée.
Groupes de préréglagesSélectionnez uniquement les environnements utilisés par votre dépôt.
Chemins représentatifsOne repository-relative path per line, matched exactly as typed.

Comment créer et tester un fichier .gitignore

Choisissez les groupes de préréglages dont votre projet a besoin, puis cliquez sur Générer le .gitignore. Les onze groupes reprennent les listes habituelles pour Node.js, Python, PHP/Composer, Java/Gradle, Go, Rust, macOS, Windows, VS Code, JetBrains et les fichiers d’environnement locaux ; les lignes identiques ne sont écrites qu’une fois et chaque groupe garde son commentaire et sa ligne vide.

Le panneau des chemins est le testeur. Saisissez un chemin relatif au dépôt par ligne, puis cliquez sur Tester les chemins : chaque ligne est comparée aux motifs générés et le rapport répond ignoré ou inclus avec le motif qui a décidé. La comparaison suit les règles de gitignore(5) : un motif contenant une barre est ancré à la racine du dépôt, * s’arrête à la barre, ** la franchit, ? vaut un caractère, [abc] est une classe de caractères, une barre finale limite le motif aux répertoires et tout ce qui se trouve sous un répertoire ignoré reste ignoré.

  1. Sélectionnez les groupes de préréglages. Node.js, macOS, VS Code et Environment secrets sont cochés au départ ; décochez ce que le dépôt n’utilise pas.
  2. Cliquez sur Générer le .gitignore. Le panneau de sortie contient le fichier fusionné : un commentaire par groupe, sans doublon, avec les négations comme !.env.example et un saut de ligne final.
  3. Saisissez les chemins de test dans le panneau central : un par ligne, relatifs à la racine du dépôt et sans barre initiale. Les espaces comptent, comme dans Git.
  4. Cliquez sur Tester les chemins. Chaque ligne indique ignoré ou inclus et le motif qui l’a décidé ; les avertissements en dessous signalent les cas que Git traite autrement.
  5. Copiez le fichier ou téléchargez-le en .gitignore, ou cliquez sur Effacer pour recommencer. Les préréglages vivent dans le script de la page : rien n’est envoyé.

Ce que le testeur décide, et où il s’arrête

Comment les groupes sont fusionnés

Chaque groupe est une liste fixe de lignes. Le générateur écrit les groupes sélectionnés dans l’ordre des cases, ignore une ligne déjà présente dans un groupe précédent et conserve une ligne vide entre les groupes. Les négations fournies avec les groupes VS Code et environnement sont des lignes ordinaires et restent telles quelles.

Rien n’est téléchargé pendant la génération : les listes viennent du script de la page, donc la même sélection produit toujours le même texte et le fichier peut être créé hors ligne.

Comment un chemin est testé

Le testeur transforme chaque ligne du fichier généré en motif et parcourt le chemin depuis la racine du dépôt. Une correspondance sur un répertoire parent décide le chemin avant la lecture de ses propres règles : c’est pourquoi .vscode/settings.json reste ignoré avec la sélection par défaut alors que le fichier contient aussi !.vscode/settings.json.

Un chemin saisi sans barre finale est testé comme fichier, puis comme répertoire : une règle comme logs/ couvre donc aussi un chemin écrit logs. Le rapport affiche le motif qui a décidé chaque ligne, négations comprises.

Ce que signifient les avertissements

Deux situations sont signalées pour le fichier généré : un motif qui se termine par un espace non échappé (Git le supprime avant la comparaison) et une négation dont le répertoire parent est exclu (Git n’y descend pas, la négation ne peut donc rien réinclure).

Chaque rapport se termine par la même limite : les fichiers .gitignore imbriqués, core.excludesFile, les systèmes de fichiers insensibles à la casse et le reste du moteur Git complet ne font pas partie de ce test.

Outils récents :