Ignorer des fichiers

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

Vous pouvez créer un fichier .gitignore 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’omission avec les autres utilisateurs qui clonent le référentiel, commitez le fichier .gitignore dans votre référentiel.

GitHub garde une liste officielle de fichiers .gitignore recommandés pour de nombreux systèmes d’exploitation, environnements et langages populaires dans le référentiel public. Vous pouvez également utiliser gitignore.io afin de créer un fichier .gitignore 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. Ouvrez TerminalTerminalGit Bash.

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

3. Créez un fichier .gitignore pour votre référentiel.

   touch .gitignore
   

   Si la commande réussit, il n’y a pas de sortie.

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

Si vous voulez ignorer un fichier déjà archivé, vous devez annuler 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é ignore placé à l’intérieur du répertoire ~/.config/git. Par défaut, Git ignore tous les fichiers et répertoires listés dans le fichier de configuration globale ~/.config/git/ignore. Si le répertoire git et le fichier ignore 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 .gitignore à 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é .git/info/exclude à 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. Ouvrez TerminalTerminalGit Bash.
2. Accédez à l’emplacement de votre dépôt Git.
3. Dans votre éditeur de texte préféré, ouvrez le fichier .git/info/exclude.

Pour aller plus loin

• 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