Git Cheat Sheet

Lê ou define opções de configuração do Git em três níveis: sistema, utilizador (global) ou repositório (local).

git config --global user.name "John Doe"
git config --global user.email "john.doe@example.com"

Define como o Git memoriza credenciais HTTPS para não pedir password a cada push.

git config --global credential.helper manager

Define um .gitignore global aplicado a todos os repositórios.

git config --global core.excludesfile ~/.gitignore_global

Cria um repositório Git novo no directório actual.

git init
git init --initial-branch=main meu-projeto

Copia um repositório remoto para a máquina local com toda a história.

git clone https://github.com/user/repo.git

Mostra o estado da working directory e do staging: o que está modificado, staged ou untracked.

git status

Move alterações da working directory para o staging area, preparando-as para o próximo commit.

git add src/components/Button.tsx
git add .

Grava o conteúdo do staging num novo commit do repositório local com uma mensagem.

git commit -m "feat: adiciona git cheat sheet"

Restaura ficheiros: tira do staging ou desfaz alterações na working directory.

git restore --staged file.txt
git restore file.txt

Remove ficheiros do repositório (e opcionalmente do disco).

git rm secret.env

Renomeia ou move um ficheiro tracked, equivalente a mv + git add + git rm.

git mv old.tsx new.tsx

Lista, cria, renomeia ou apaga branches.

git branch
git branch feature/login

Comando antigo para mudar de branch ou repor ficheiros. Hoje recomenda-se git switch e git restore.

git checkout main
git checkout -b feature/x

Versão moderna do checkout só para mudar de branch.

git switch main
git switch -c feature/login

Junta as alterações de outra branch na actual, criando um commit de merge se necessário.

git switch main
git merge feature/login

Reaplica os commits da branch actual por cima de outra base, reescrevendo a história.

git switch feature
git rebase main

Aplica um commit específico de outra branch na actual.

git cherry-pick a1b2c3d

Abre uma ferramenta gráfica para resolver conflitos de merge.

git mergetool --tool=meld

Gere os remotos do repositório (origin, upstream, etc).

git remote -v

Descarrega commits e refs do remoto sem os integrar na branch local.

git fetch origin

Equivale a git fetch seguido de git merge (ou rebase) na branch actual.

git pull origin main

Envia commits locais para o remoto.

git push -u origin feature/login

Guarda alterações não commitadas numa pilha temporária para limpar a working directory.

git stash push -m "WIP login"

Manipulação da pilha de stashes.

git stash list
git stash pop

Cria, lista, apaga ou verifica tags. As tags marcam pontos no histórico (releases).

git tag -a v1.2.0 -m "Release 1.2"

Devolve um nome legível baseado na tag mais próxima.

git describe --tags --always --dirty

Mostra o histórico de commits com filtros e formatação flexíveis.

git log --oneline --graph --decorate --all

Mostra o conteúdo de um commit, tag ou objecto.

git show HEAD
git show a1b2c3d:src/file.tsx

Mostra diferenças entre working dir, staging, commits ou branches.

git diff
git diff --cached
git diff main feature

Mostra quem alterou cada linha de um ficheiro e em que commit.

git blame -L 10,30 file.tsx

Resumo agrupado por autor (útil para release notes).

git shortlog -sne

Histórico local de tudo o que o HEAD tocou. Salva-vidas para recuperar commits perdidos.

git reflog
git reset --hard HEAD@{2}

Move HEAD para outro commit, opcionalmente alterando staging e working dir.

git reset --soft HEAD~1
git reset --mixed HEAD~1
git reset --hard HEAD~1

Cria um novo commit que desfaz as alterações de outro. Seguro em branches partilhadas.

git revert a1b2c3d

Apaga ficheiros untracked da working directory. Operação destrutiva.

git clean -nfd

Adiciona um repositório como submódulo dentro do actual.

git submodule add -b main https://github.com/user/lib.git vendor/lib

Inicializa e descarrega submódulos definidos em .gitmodules.

git submodule update --init --recursive

Vê estado, corre comando em cada submódulo, ou desactiva-o.

git submodule foreach 'git pull origin main'

Cria um ficheiro executável em .git/hooks/ com o nome do evento (pre-commit, pre-push, commit-msg, post-merge, etc).

printf '#!/bin/sh\nnpm run lint\n' > .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

Define um directório de hooks partilhado (versionável, fora de .git).

git config core.hooksPath .githooks

Ferramenta JS para versionar hooks no package.json e instalá-los automaticamente.

npx husky init
echo "npm test" > .husky/pre-commit

Salta os hooks pre-commit e commit-msg (usar com moderação).

git commit --no-verify -m "hotfix"

Busca binária no histórico para encontrar o commit que introduziu um bug.

git bisect start
git bisect bad HEAD
git bisect good v1.0
git bisect reset

Cria múltiplas working directories ligadas ao mesmo .git, permitindo trabalhar em várias branches em paralelo.

git worktree add ../proj-hotfix hotfix/urgente

Reescreve histórico: combina, reordena, edita ou apaga commits.

git rebase -i HEAD~5
# pick    a1b2 feat: x
# squash  c3d4 fix typo
# reword  e5f6 chore: y
# drop    g7h8 wip

Reescreve a história em massa, substituto moderno do git filter-branch. Útil para remover ficheiros sensíveis.

git filter-repo --path secrets.env --invert-paths

Cria um tarball ou zip do conteúdo de uma ref, sem .git.

git archive --format=zip --prefix=app/ -o release.zip v1.0

Empacota commits num ficheiro único, transferível offline.

git bundle create repo.bundle --all
git clone repo.bundle nova-pasta

Resolve uma referência num SHA completo, curto ou nome.

git rev-parse HEAD
git rev-parse --abbrev-ref HEAD
git rev-parse --short HEAD

Inspecciona objectos do Git (blobs, trees, commits, tags).

git cat-file -p HEAD
git cat-file -t a1b2c3d

Lista ficheiros tracked (ls-files) ou conteúdo de uma tree (ls-tree).

git ls-files
git ls-tree -r HEAD --name-only

Manutenção: garbage collection, integridade, remoção de objectos soltos.

git gc --aggressive --prune=now
git fsck --full

Permite ter só um subconjunto da árvore localmente, útil para monorepos grandes.

git sparse-checkout init --cone
git sparse-checkout set apps/web libs/ui

Adiciona notas a commits sem alterar o seu SHA.

git notes add -m "reviewed by QA" HEAD