Aller au contenu principal

Git clean : supprimer les fichiers non suivis

Des fichiers temporaires, des logs, des builds qui traînent ? git clean nettoie ton répertoire de travail en supprimant tout ce qui n'est pas tracké par Git.

GitQuest
Démo

Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le

Attention

C'est quoi git clean ?

git clean supprime les fichiers non trackés de ton répertoire de travail. Ce sont les fichiers que Git ne connaît pas : ils n'ont jamais été ajoutés avec git add.

C'est utile pour repartir d'un état propre : supprimer des fichiers temporaires, des logs de debug, des artefacts de build.

Attention : git clean est irréversible. Les fichiers supprimés ne peuvent pas être récupérés. Utilise toujours -n (dry run) avant -f (force).

Options de git clean

git clean -n

Dry run : montre ce qui serait supprimé

git clean -f

Force : supprime les fichiers non trackés

git clean -fd

Supprime fichiers ET dossiers non trackés

git clean -fx

Supprime aussi les fichiers ignorés (.gitignore)

git clean -i

Mode interactif : choisir fichier par fichier

Git clean en pratique

Toujours vérifier avec -n avant de supprimer avec -f.

Dry run puis clean

Avec dossiers et fichiers ignorés

Quand utiliser git clean ?

Nettoyer après un build

Supprimer les artefacts de compilation (dist/, build/, .cache/) pour repartir d'un état propre avant un nouveau build.

Supprimer les fichiers de test

Des fichiers temporaires créés pendant le debug (logs, exports, screenshots) qui n'ont pas vocation à être commités.

Repartir de zéro

Combine avec git checkout ., tu peux revenir à un état identique au dernier commit, sans aucun fichier supplémentaire.

Regles de sécurité avec git clean

!

Toujours -n avant -f

Lance git clean -n pour voir ce qui sera supprimé. Puis git clean -f seulement si la liste est correcte.

!

Attention à -x

Le flag -x supprime aussi les fichiers ignorés par .gitignore. Ça inclut .env, node_modules, etc. Utilise-le avec précaution.

+

Préfère le mode interactif

git clean -i te permet de choisir fichier par fichier ce que tu veux supprimer. Plus lent mais plus sûr.

+

Vérifie ton .gitignore

Assure-toi que ton .gitignore est à jour. Les fichiers non ignorés et non trackés seront supprimés par git clean.

Fait partie du guide Annuler des modifications Git

A

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

Questions sur git clean

Apprends à nettoyer ton dépôt sans risque

GitQuest te propose des scénarios où tu dois utiliser git clean dans un environnement sécurisé.