Início·Comandos de terminal

git mv

git

Uso

git mv [-f] <source> <destination>

Move um arquivo e prepara a mudança de uma vez; o git não guarda renomeações, ele as deduz pelo conteúdo parecido, e uma troca só de maiúsculas precisa de -f no macOS e no Windows.

Opções comuns

OpçãoSignificado
-foverwrite the destination
-kskip moves that would fail instead of stopping
-ndry run
-vname each file as it moves

Exemplos

git mv old.md docs/new.md

moves the file and stages the change in one step

git mv -n src/a.ts src/b.ts

shows what it would do

git mv README.md readme.md

a case-only rename, which needs -f on macOS and Windows

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 mv faz?

Move um arquivo e prepara a mudança de uma vez; o git não guarda renomeações, ele as deduz pelo conteúdo parecido, e uma troca só de maiúsculas precisa de -f no macOS e no Windows.

Q. Como se digita?

git mv [-f] <source> <destination> — os colchetes marcam o que você pode omitir.

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

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

Comandos relacionados

página man: man git-mv