git clean în Git

Șterge fișierele și directoarele neurmărite (untracked) din directorul de lucru.

Sintaxă comandă
git clean [opțiuni] [cale...]

Ce face git clean

Comanda git clean curăță directorul de lucru de fișierele generate automat, artefacte de build, fișiere de test sau foldere create accidental care nu sunt urmărite de Git.

Din motive de siguranță, Git refuză să șteargă fișiere fără opțiunea -f (force). Este o practică excelentă să rulezi mai întâi o simulare cu -n (dry run) pentru a vedea exact ce ar fi eliminat.

Opțiuni și argumente

Opțiune / Parametru Descriere
-n, --dry-run Simulare sigură: afișează lista fișierelor care ar fi șterse FĂRĂ a le șterge efectiv.
-f, --force Forțează ștergerea fișierelor neurmărite.
-d Include și directoarele întregi neurmărite în procesul de curățare.
-x Șterge și fișierele care sunt ignorate conform regulilor din .gitignore (curățare completă de build).

Exemple

Exemplul 1: Simularea și curățarea fișierelor reziduale

Verificăm mai întâi cu -n, apoi eliminăm fișierele cu -f.

git init -b main demo_clean >/dev/null
cd demo_clean
touch test_untracked.tmp
git clean -f
ls

Rezultat

Removing test_untracked.tmp

Greșeli frecvente

  • Rularea git clean -fdx fără verificare: parametrul -x va șterge și fișierele din .gitignore, inclusiv fișierele locale de configurare (cum ar fi .env cu parole și chei de API care nu sunt în Git).

Comenzi înrudite

  • git status: Afișează starea fișierelor: modificate, pregătite pentru commit (staged) sau neurmărite (untracked).
  • git reset: Mută indicatorul ramurii curente (HEAD) la un commit anterior și ajustează staging-ul sau fișierele locale.
  • git restore: Restaurează fișierele din directorul de lucru sau scoate modificările din zona de staging.