Fluxos de Trabalho Avançados do Git

Domine técnicas avançadas do Git para manter um histórico limpo, colaborar efetivamente e se recuperar de qualquer situação com confiança.

Não use esta habilidade quando

• A tarefa não estiver relacionada a fluxos de trabalho avançados do Git
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique as melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.

Quando Usar

• Limpar o histórico de commits antes de mesclar
• Aplicar commits específicos entre branches
• Encontrar commits que introduziram bugs
• Trabalhar em vários recursos simultaneamente
• Recuperar-se de erros do Git ou commits perdidos
• Gerenciar fluxos de trabalho complexos de branches
• Preparar Pull Requests (PRs) limpos para revisão
• Sincronizar branches divergentes

Limites de Repositório e Recuperação

Leia as instruções do repositório e a proteção de branches primeiro. Um hotfix segue o caminho protegido de PR/mantenedor quando necessário; a urgência não autoriza um commit ou push direto para a branch padrão. Preserve o trabalho sujo e preparado antes de fazer checkout, rebase, reset ou restore. Uma branch de backup protege apenas o histórico commitado, não os arquivos não commitados. Inspecione os alvos exatos antes de operações destrutivas e obtenha autorização para reescritas de histórico compartilhado. A disponibilidade do reflog depende da expiração local e da coleta de lixo; ele não pode garantir a recuperação de todos os arquivos perdidos.

Conceitos Principais

1. Rebase Interativo

O rebase interativo é a faca suíça da edição de histórico do Git.

Operações Comuns:

• pick: Manter o commit como está
• reword: Alterar a mensagem do commit
• edit: Modificar o conteúdo do commit
• squash: Combinar com o commit anterior
• fixup: Semelhante a squash, mas descarta a mensagem
• drop: Remover o commit completamente

Uso Básico:

# Rebase last 5 commits
git rebase -i HEAD~5

# Rebase all commits on current branch
git rebase -i $(git merge-base HEAD main)

# Rebase onto specific commit
git rebase -i abc123

2. Cherry-Picking

Aplicar commits específicos de uma branch para outra sem mesclar branches inteiras.

# Cherry-pick single commit
git cherry-pick abc123

# Cherry-pick range of commits (exclusive start)
git cherry-pick abc123..def456

# Cherry-pick without committing (stage changes only)
git cherry-pick -n abc123

# Cherry-pick and edit commit message
git cherry-pick -e abc123

3. Git Bisect

Busca binária através do histórico de commits para encontrar o commit que introduziu um bug.

# Start bisect
git bisect start

# Mark current commit as bad
git bisect bad

# Mark known good commit
git bisect good v1.0.0

# Git will checkout middle commit - test it
# Then mark as good or bad
git bisect good  # or: git bisect bad

# Continue until bug found
# When done
git bisect reset

Bisect Automatizado:

# Use script to test automatically
git bisect start HEAD v1.0.0
git bisect run ./test.sh

# test.sh should exit 0 for good, 1-127 (except 125) for bad

4. Worktrees

Trabalhe em várias branches simultaneamente sem usar stash ou trocar de branch.

# List existing worktrees
git worktree list

# Add new worktree for feature branch
git worktree add ../project-feature feature/new-feature

# Add worktree and create new branch
git worktree add -b bugfix/urgent ../project-hotfix main

# Remove worktree
git worktree remove ../project-feature

# Prune stale worktrees
git worktree prune

5. Reflog

Sua rede de segurança - rastreia todos os movimentos de referências, até mesmo commits deletados.

# View reflog
git reflog

# View reflog for specific branch
git reflog show feature/branch

# Restore deleted commit
git reflog
# Find commit hash
git checkout abc123
git branch recovered-branch

# Restore deleted branch
git reflog
git branch deleted-branch abc123

Fluxos de Trabalho Práticos

Fluxo de Trabalho 1: Limpar Branch de Recurso Antes do PR

# Start with feature branch
git checkout feature/user-auth

# Interactive rebase to clean history
git rebase -i main

# Example rebase operations:
# - Squash "fix typo" commits
# - Reword commit messages for clarity
# - Reorder commits logically
# - Drop unnecessary commits

# Force push cleaned branch (safe if no one else is using it)
git push --force-with-lease origin feature/user-auth

Fluxo de Trabalho 2: Aplicar Hotfix em Múltiplas Versões

# Criar correção em uma branch de tópico autorizada a partir do alvo atual
git fetch origin main
git switch -c hotfix/security origin/main
git commit -m "fix: critical security patch"

# Aplicar em branches de release

…