Ninguém se lembra de todos os comandos do Git e você não precisa disso. Esta folha de dicas de comandos do Git concentra-se no pequeno conjunto que cobre quase todo o trabalho diário, agrupado pelo trabalho que você está tentando realizar.

Testamos os comandos locais em um repositório de demonstração descartável usando Git para Windows, e a saída mostrada vem dessa execução, com avisos de final de linha removidos. Seus hashes de commit serão diferentes. Os comandos remotos precisam de um servidor, por isso não os executamos. Novo no controle de versão? Comece com nosso tutorial do Git para iniciantes.

Como o Git pensa: três áreas

A maior parte da confusão desaparece quando você sabe onde reside uma mudança:

Configurar e iniciar um projeto

Salve seu trabalho

Veja como a visualização resumida do status muda à medida que um novo arquivo avança:

$ echo "hello" > app.txt
$ git status --short
?? app.txt

$ git add app.txt
$ git status --short
A  app.txt

$ git commit -m "Add app file"

?? significa não rastreado e A significa adicionado à preparação. No formato de duas colunas, a coluna da esquerda é a área de preparação e a coluna da direita é o seu diretório de trabalho. Observe que git commit -am ignora arquivos novos, então você deve adicioná-los explicitamente primeiro.

Filiais

Aqui está um pequeno ramo de recursos do início ao fim:

$ git switch -c feature/login
$ echo "login" >> app.txt
$ git commit -am "Add login"
$ git switch main
$ git merge --no-edit feature/login
$ git log --oneline --graph
* d0450b6 Add login
* 676b684 Add app file

$ git branch -d feature/login
Deleted branch feature/login (was d0450b6).

A história é uma linha reta porque main não foi movido, então o Git fez uma fusão rápida. Você ainda verá git checkout em guias mais antigos. Funciona, mas os comandos switch e restore mais recentes dividem seus muitos trabalhos em outros mais claros. Para escolher entre mesclagem e rebase, leia Git merge vs rebase.

Trabalhando com controles remotos

fetch é sempre seguro, porque nunca altera seus arquivos. Se você precisar sobrescrever um branch após um rebase, prefira --force-with-lease ao simples --force, pois ele se recusa a eliminar os novos commits de um colega.

Stash: deixe o trabalho de lado

Stash é útil quando você precisa trocar de tarefa, mas não está pronto para confirmar:

$ echo "wip" >> app.txt
$ git stash
$ git status --short
                       # clean, the change is put away
$ git stash pop
$ git status --short
 M app.txt

Ver histórico

Desfazer erros: “Eu quero…”

Esta é a parte que a maioria das pessoas procura. Encontre sua situação:

Redefinir vs reverter vs restaurar

Esses três nomes causam muita confusão, mas fazem coisas bem diferentes:

Em nossa demonstração, cometemos uma linha incorreta e a revertemos. O arquivo voltou ao seu conteúdo anterior, enquanto o erro permaneceu visível no log como histórico:

$ echo "oops" >> app.txt
$ git commit -am "Bad change"
$ git revert --no-edit HEAD
$ cat app.txt
hello
login

Então git reset --soft HEAD~1 removeu o último commit, mas manteve suas alterações preparadas, que git status --short mostrou como M app.txt.

Etiquetas

As tags geralmente acionam pipelines de lançamento, como explica nosso guia de CI/CD de ações do GitHub.

Um fluxo de trabalho diário simples

git switch main
git pull
git switch -c feature/search
# edit files
git status
git add -p
git commit -m "Add search by product name"
git push -u origin feature/search
# open a pull request, get a review, then merge

Escreva mensagens de commit que expliquem a mudança no imperativo, como “Corrigir redirecionamento de login”. Você vai se agradecer ao ler o registro daqui a seis meses.

Erros comuns

• Comprometendo segredos. Remover um arquivo em um commit posterior não o remove do histórico. Gire o segredo imediatamente e use .gitignore.
• Reescrevendo o histórico compartilhado. Não redefina ou rebase commits que outras pessoas já extraíram.
• Usando git add . cegamente. Verifique git status primeiro, para que os arquivos de compilação e logs fiquem de fora.
• Usando --force simples. Prefira --force-with-lease.
• Fazer commits enormes. Os pequenos são mais fáceis de revisar, reverter e dividir.

Considerações finais

Aprenda as três áreas e uma dúzia de comandos e o Git deixará de ser assustador. Mantenha a tabela de desfazer à mão e lembre-se de que git status e git reflog são sua rede de segurança. Para aumentar a confiança, crie um repositório descartável e quebre-o e repare-o deliberadamente, já que esse é o lugar mais barato para cometer erros.

Perguntas frequentes

Continue aprendendo