Git: Remover Arquivos Não Rastreados
Última atualização
Arquivos não rastreados são arquivos que o Git ainda não gerencia: saída de build, logs, arquivos temporários. O git clean os exclui da árvore de trabalho. Como ele remove permanentemente arquivos que nunca foram commitados, sempre visualize primeiro com -n (uma execução de teste) antes de rodá-lo de verdade com -f.
Experimente isto no terminal playground: um shell real no seu navegador, nada para instalar.
Sintaxe
| Command | What it does |
|---|---|
git clean -n | Execução de teste: lista o que seria removido |
git clean -f | Exclui arquivos não rastreados (flag de force obrigatório) |
git clean -fd | Também remove diretórios não rastreados |
git clean -fx | Também remove arquivos ignorados |
git clean -fdx | Remove tudo o que não é rastreado, diretórios e ignorados |
Fluxo de trabalho seguro
Visualize e depois exclua, para que nada seja removido de surpresa.
| Step | Command | Result |
|---|---|---|
| 1 | git clean -nd | Veja cada arquivo e pasta que seria removido |
| 2 | git clean -fd | Exclua-os depois de confirmar a lista |
Perguntas frequentes sobre remover arquivos não rastreados no Git
Como remover arquivos não rastreados no Git?
Use
git clean. Primeiro visualize com git clean -n para listar o que seria excluído, depois rode git clean -f para remover de fato os arquivos não rastreados. O flag -f (force) é obrigatório porque o clean é destrutivo por natureza.Como remover também os diretórios não rastreados?
Adicione o flag
-d: git clean -fd remove arquivos não rastreados e diretórios não rastreados. O git clean -f sozinho remove apenas arquivos, deixando para trás as pastas vazias não rastreadas.O git clean exclui arquivos ignorados?
Não por padrão: arquivos correspondentes ao
.gitignore são deixados em paz. Adicione -x para incluí-los (git clean -fx), ou -fdx para apagar tudo o que não é rastreado, incluindo arquivos e diretórios ignorados. Use -x com cuidado, pois pode excluir configurações locais e caches de build que você pretendia manter.Posso desfazer o git clean?
Não. O
git clean exclui permanentemente arquivos que nunca foram commitados, então não há nada no histórico do Git de onde recuperá-los. É exatamente por isso que você deve sempre rodar git clean -n primeiro para revisar a lista antes de excluir.Posso praticar isto online?
Sim. Abra o terminal playground para rodar
git clean em um shell real no seu navegador, nada para instalar. O curso interativo e gratuito de Git da Coddy também cobre como gerenciar sua árvore de trabalho passo a passo.Recursos relacionados
Mais comandos do Git
