Git cheatsheet

Atualizar o repositório local

git pull

Baixa e integra as mudanças do repositório remoto no branch atual.

Verificar o estado atual

git status

Mostra quais arquivos foram modificados, adicionados ou removidos desde o último commit.

Criar um branch novo

git checkout -b nome-do-branch

Cria e já muda para o novo branch. O -b significa "create branch".

Mudar de branch

git checkout main

Volta para o branch main. Substitua main por qualquer nome de branch.

Deletar um branch local

git branch -D nome-do-branch

Força a exclusão do branch local. O -D deleta mesmo sem merge. Use -d (minúsculo) se quiser segurança — ele só deleta se o branch já foi mergeado.

Descartar alterações em um arquivo

git checkout -- caminho/do/arquivo

Restaura o arquivo para o estado do último commit, descartando todas as mudanças locais.

Adicionar arquivo ao commit

git add caminho/do/arquivo

Marca o arquivo para ser incluído no próximo commit.

Fazer um commit

git commit -m "mensagem do commit"

Salva as mudanças marcadas com uma mensagem descritiva.

Enviar para o repositório remoto

git push origin nome-do-branch

Envia o branch local para o repositório remoto. Na primeira vez que envia um branch novo, o origin nome-do-branch é necessário. Para o main já configurado, git push basta.

Fluxo completo para um PR

git pull                                    # atualiza o main
git checkout -b feat/nome-da-feature        # cria o branch
# faz as alterações nos arquivos
git add caminho/do/arquivo                  # marca as mudanças
git commit -m "feat: descrição da mudança"  # commit
git push origin feat/nome-da-feature        # envia para o remoto
# abre o PR no GitHub

Após o merge do PR, limpar o branch

git checkout main
git pull
git branch -D feat/nome-da-feature

Convenção de nomes para branches

Convenção de mensagens de commit

Seguimos o padrão Conventional Commits:

Exemplo: feat: upgrade Mermaid from v10 to v11