Início·Comandos de terminal

git rm

git

Uso

git rm [--cached] [-r] <pathspec>

Remove um arquivo do índice e do disco; --cached mantém o arquivo e só para de rastreá-lo, mas o conteúdo antigo fica no histórico, então um segredo vazado continua lá.

Opções comuns

OpçãoSignificado
--cachedstop tracking but leave the file on disk
-rrecurse into directories
-fremove even when the file has unstaged changes
-ndry run
--ignore-unmatchexit 0 even if nothing matched

Exemplos

git rm --cached .env

stops tracking a secret file while keeping it locally

git rm -r build/

deletes the folder from the repository and from disk

git rm -n "*.log"

shows what would be removed

O confuso é que desfazer tem várias formas: mover para onde um branch aponta não é o mesmo que criar um commit que reverte.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que git rm faz?

Remove um arquivo do índice e do disco; --cached mantém o arquivo e só para de rastreá-lo, mas o conteúdo antigo fica no histórico, então um segredo vazado continua lá.

Q. Como se digita?

git rm [--cached] [-r] <pathspec> — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 5; a lista completa está em man git. Este comando fica em git.

Comandos relacionados

página man: man git-rm