Início·Comandos de terminal

git branch

git

Uso

git branch [-a|-vv] [-d <name>]

Lista, cria e apaga branches localmente; apagar um não mexe no remoto, o servidor ainda pede git push origin --delete.

Opções comuns

OpçãoSignificado
-alocal and remote-tracking branches
-rremote-tracking branches only
-vvlast commit and upstream of each branch
-d <name>delete a branch that is already merged
-D <name>delete it even if unmerged; those commits are left behind
-m <old> <new>rename
--mergedbranches already contained in the current one
--show-currentprint the branch you are on

Exemplos

git branch -vv

every local branch with its upstream and last commit

git branch -d old-feature

removes a merged branch locally only

git push origin --delete old-feature

the separate step that removes it on the server

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

Lista, cria e apaga branches localmente; apagar um não mexe no remoto, o servidor ainda pede git push origin --delete.

Q. Como se digita?

git branch [-a|-vv] [-d <name>] — os colchetes marcam o que você pode omitir.

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

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

Comandos relacionados

página man: man git-branch