Entendendo o comando "git branch"

Olá, devs.

Neste pequeno artigo vamos entender, de maneira prática, como funciona o comando "git branch".

1. "git branch":

O comando "git branch", sem parâmetros adicionais, lista todos as branches (ramos) do nosso repositório local. Abaixo, após inserir o comando no terminal, vemos que há duas branches: "main" e "feature/crud-users". O asterisco indica a branch que estamos localizados.

PS C:\Users\guico\Documents\artigo> git branch

feature/crud-users
* main

2. "git branch -a"

Ao passar a flag -a, teremos a listagem das branches locais e remotas:

PS C:\Users\guico\Documents\artigo> git branch -a
feature/crud-users
* main
remotes/origin/develop
remotes/origin/feature/crud-users
remotes/origin/main

3. "git branch <nome-da-branch>"

Com este comando, estaremos criando uma nova branch a partir da branch em que estamos. Ou seja, se estivermos na branch main e utilizandos o "git branch <nome-da-branch>", essa nova branch iniciará no ponto em que está a main:

PS C:\Users\guico\Documents\artigo> git branch nova-branch
PS C:\Users\guico\Documents\artigo> git branch
feature/crud-users
* main
nova-branch

4. "git branch -m <nome-da-branch> <novo-nome-da-branch"

Ao utilizar a flag -m, podemos renomear uma branch. Para isso, informamos o nome da branch que queremos renomear e, logo em seguida, o novo nome dessa branch:

PS C:\Users\guico\Documents\artigo> git branch -m nova-branch branch-renomeada
PS C:\Users\guico\Documents\artigo> git branch
* branch-renomeada
 feature/crud-users
 main

5. "git branch -d <nome-da-branch>"

Podemos utilizar a flag -d para deletar uma branch, como no exemplo abaixo, onde deletamos a branch chamada "branch-renomeada".

OBS: Para deletar uma branch é necessário que não estejamos nela. Caso esteja, utilize o comando "git checkout <nome-da-branch" para mudar para outra branch existente.

PS C:\Users\guico\Documents\artigo> git branch -d branch-renomeada
Deleted branch branch-renomeada (was 5b931d0).

6. "git branch -v"

Com a flag -v, conseguimos ver quais foram os últimos commits de cada uma das branches locais:

PS C:\Users\guico\Documents\artigo> git branch -v
 feature/crud-users ef61dc2 5. ajuste get users
* main        5b931d0 12. repository de posts

7. "git branch -a -v"

Utilizando a flag -a em conjunto com -v, conseguimos ver quais foram os últimos commits de cada uma das branches locais e remotas:

PS C:\Users\guico\Documents\artigo> git branch -a -v
 feature/crud-users        ef61dc2 5. ajuste get users
* main               5b931d0 12. repository de posts
 remotes/origin/develop      5b931d0 12. repository de posts
 remotes/origin/feature/crud-users ef61dc2 5. ajuste get users
 remotes/origin/main        5b931d0 12. repository de posts

CONCLUSÃO

Em resumo, o comando "git branch" é uma ferramenta essencial para a administração eficiente de branches em repositórios Git. Sua versatilidade permite desde a identificação e navegação entre branches locais e remotos até a criação, renomeação e exclusão de ramificações. Ao compreender e aplicar esses recursos, os desenvolvedores conseguem manter um ambiente de desenvolvimento organizado e colaborativo, garantindo um histórico de projeto gerenciável e facilitando a coordenação entre membros da equipe. O conhecimento aprofundado dessas funcionalidades contribui para aprimorar a eficiência e a qualidade do processo de desenvolvimento em equipe.