Ignorer des fichiers

Configuration des fichiers ignorés pour un dépôt spécifique

Vous pouvez créer un fichier dans le répertoire racine de votre référentiel pour indiquer à Git les fichiers et répertoires à ignorer quand vous faites un commit. Pour partager les règles d'ignorance avec d’autres utilisateurs qui clonent le référentiel, validez le fichier dans votre référentiel.

GitHub conserve une liste officielle des fichiers .gitignore recommandés pour de nombreux systèmes d’exploitation, environnements et langues populaires dans le référentiel public « github/gitignore ». Vous pouvez également utiliser gitignore.io afin de créer un fichier pour votre système d’exploitation, votre langage de programmation ou votre IDE. Pour plus d’informations, consultez github/gitignore et le site gitignore.io.

1. Accédez à l’emplacement de votre dépôt Git.

2. Créez un fichier pour votre référentiel.

   touch .gitignore
   

   Si la commande réussit, il n’y aura aucune sortie.

Pour obtenir un exemple de fichier , consultez Configurations .gitignore courantes dans le référentiel Octocat.

Si vous voulez ignorer un fichier déjà validé, vous devez arrêter le suivi du fichier avant d’ajouter une règle pour l’ignorer. Dans votre terminal, annulez le suivi du fichier.

git rm --cached FILENAME

Configuration des fichiers ignorés pour tous les dépôts sur votre ordinateur

Vous pouvez indiquer à Git de toujours ignorer certains fichiers ou répertoires lorsque vous effectuez un commit dans n’importe quel référentiel Git sur votre ordinateur. Par exemple, vous pouvez utiliser cette fonctionnalité pour ignorer les fichiers de sauvegarde temporaires créés par votre éditeur de texte.

Pour toujours ignorer un fichier ou un répertoire donné, ajoutez-le à un fichier nommé placé à l’intérieur du répertoire . Par défaut, Git ignore tous les fichiers et répertoires listés dans le fichier de configuration globale . Si le répertoire et le fichier n’existent pas encore, vous devrez peut-être les créer.

Exclusion de fichiers locaux sans créer de fichier .gitignore

Si vous ne voulez pas créer de fichier à partager avec d’autres personnes, vous pouvez créer des règles qui ne sont pas commitées avec le référentiel. Vous pouvez utiliser cette technique pour les fichiers générés localement dont vous ne voulez pas qu’ils soient générés par d’autres utilisateurs, comme les fichiers créés par votre éditeur.

Utilisez l’éditeur de texte de votre choix pour ouvrir le fichier appelé à la racine de votre référentiel Git. Toute règle que vous ajoutez ici n’est pas archivée et ignore uniquement les fichiers de votre dépôt local.

1. Accédez à l’emplacement de votre dépôt Git.
2. Dans votre éditeur de texte préféré, ouvrez le fichier .

Lectures complémentaires

• Ignorer des fichiers dans la documentation de Git
• .gitignore dans la documentation Git
• Collection de modèles .gitignore utiles dans le dépôt github/gitignore
• Site gitignore.io