git clean

Instantanés de base

Supprimer les fichiers non suivis du répertoire de travail

La commande 'git clean' supprime les fichiers non suivis — des fichiers que Git n’a jamais stockés, comme des logs, des résultats de build ou des essais. Comme Git n’en a aucune copie, les fichiers supprimés ne peuvent pas être récupérés. C’est pourquoi git clean refuse de s’exécuter sans -f, et git clean -n montre d’abord ce qui serait supprimé. Les fichiers de .gitignore sont gardés, sauf si vous ajoutez -x.

Synopsis

git clean [-d] [-f] [-i] [-n] [-q] [-e <pattern>] [-x | -X] [--] [<pathspec>...]
[ ] facultatif| ou<arg> valeur à remplacer... répétable--flag option

Options

Cliquez sur une option pour la déplier

Débutant (3)

Ne rien supprimer, juste montrer ce qui serait supprimé.

RecommandéToujours prévisualiser avant de supprimer définitivement

Exemple

git clean -n

Supprimer réellement les fichiers. Obligatoire, sauf si clean.requireForce vaut false.

Si nécessaireObligatoire pour supprimer ; les fichiers sont perdus pour de bon

Exemple

git clean -f

Supprimer aussi les dossiers non suivis, pas seulement les fichiers non suivis.

Si nécessaireNécessaire quand les restes sont des dossiers entiers

Exemple

git clean -fd

Intermédiaire (1)

Supprimer aussi les fichiers que .gitignore protège normalement.

DéconseilléSupprime aussi les fichiers ignorés comme .env ou les réglages locaux

Exemple

git clean -f -x

Choisir la bonne option

Ce que supprime chaque commande

Suivi ou non suivi

CommandeFichiers non suivisFichiers ignorésModifications des fichiers suivis
git clean -fSuppriméConservéConservé
git clean -f -xSuppriméSuppriméConservé
git restore .ConservéConservéJeté
git stash -uMis de côté (stash)ConservéMis de côté (stash)

Exemples

Aperçu

git clean -n

Liste les fichiers non suivis qui seraient supprimés.

Supprimer les fichiers non suivis

git clean -f

Les supprime définitivement.

Les dossiers aussi

git clean -fd

Supprime aussi les dossiers non suivis.

Exemples de workflows

1
git status -s

Voir les fichiers non suivis (??)

2
git clean -n

Prévisualiser la suppression

3
git clean -f

Les supprimer

Dépannage

fatal: clean.requireForce is true and -f not given

Cause : git clean refuse de supprimer sans -f

Lancez git clean -n pour prévisualiser, puis git clean -f

Un dossier non suivi n’a pas été supprimé

Cause : Les dossiers demandent -d

Utilisez git clean -fd

J’ai supprimé un fichier dont j’avais besoin

Cause : Les fichiers non suivis n’ont aucune copie dans Git

Git ne peut pas le restaurer ; vérifiez votre éditeur ou vos sauvegardes. La prochaine fois, utilisez git stash -u

Astuces et pièges

Bonnes pratiques

  • ✓Lancez toujours git clean -n avant git clean -f.
  • ✓Utilisez plutôt git stash -u si vous risquez d’avoir besoin des fichiers plus tard.
  • ✓Réservez -x aux dossiers de build que vous pouvez régénérer.

Erreurs fréquentes

  • ✗Lancer git clean -f sans -n d’abord et perdre un fichier encore utile.
  • ✗Ajouter -x par habitude et supprimer des fichiers ignorés comme .env.
  • ✗S’attendre à ce que git clean annule les modifications de fichiers suivis — utilisez git restore pour cela.

FAQ

A:

Non. Les fichiers n’ont jamais été stockés dans Git.

A:

Non. Il supprime seulement les fichiers non suivis (et avec -x, les ignorés).

A:

Oui : git clean -i vous laisse choisir les fichiers un par un.