Checklist de Resolução de Conflitos de Merge

Um processo calmo e repetível para resolver conflitos de merge e rebase do Git em repositórios Rust - especialmente Cargo.toml, Cargo.lock e migrações sqlx.

Como Usar Este Checklist

• Percorra os itens em ordem durante um conflito ativo - não pule direto para a edição de marcadores.
• Resolva um arquivo completamente antes de passar para o próximo quando os conflitos forem grandes.
• Se ficar preso por mais de 30 minutos em um arquivo, forme uma dupla - lockfiles e migrações se beneficiam de um segundo revisor.
• Registre a causa do conflito na descrição do PR para evitar colisões repetidas.

Fase 1 - Estabilizar

1. Confirme o tipo de operação: git status mostra merge, rebase ou cherry-pick.
2. Liste os arquivos em conflito: git diff --name-only --diff-filter=U.
3. Aborte se estiver no branch errado: git merge --abort ou git rebase --abort.
4. Faça stash do trabalho não relacionado: git stash push -m "pré-conflito".
5. Busque o último remoto: git fetch origin.

Fase 2 - Entender

6. Leia ambos os lados: <<<<<<<, =======, >>>>>>> marcam o seu vs o recebido.
7. Verifique as mensagens de commit: git log --oneline --left-right HEAD...MERGE_HEAD.
8. Identifique a intenção semântica: formatação cosmética vs versão de dependência vs revisão de migração.
9. Regra do Lockfile: escolha o lado vencedor do Cargo.toml, remova os marcadores, execute cargo generate-lockfile ou cargo update -p crate.
10. Regra de Migração: nunca duplique IDs de revisão sqlx; pode ser necessário fazer o merge da migração após a resolução.

Fase 3 - Resolver

11. Resolva um arquivo por vez: sintaxe TOML e Rust válida, sem marcadores sobrando.
12. Prefira a política de dependência do upstream: alinhe com main, a menos que o ticket exija um bump.
13. Execute rustfmt em Rust modificado: cargo fmt -- file.rs.
14. Adicione o arquivo resolvido ao stage: git add <arquivo>; git diff --check detecta marcadores restantes.
15. Continue a operação: git rebase --continue ou complete o commit de merge.

Fase 4 - Verificar

16. Build bloqueado: cargo build --locked.
17. Fmt: cargo fmt --all -- --check.
18. Clippy: cargo clippy --all-targets -- -D warnings.
19. Testes: cargo test --all-features.
20. Migrações: sqlx migrate run quando os arquivos de migração entraram em conflito.

Fase 5 - Finalizar

21. Revise o tamanho do diff: git diff origin/main...HEAD.
22. Force push com segurança após rebase: git push --force-with-lease apenas no seu branch de feature.
23. Comentário no PR: anote os arquivos em conflito e as escolhas de resolução.
24. Prevenção: faça rebase com mais frequência se os mesmos arquivos entrarem em conflito repetidamente.
25. Sincronize com o autor: esclareça commits recebidos mal compreendidos antes do merge.

FAQs

Relacionados

• Branching & Merging
• Essential Git Commands
• Gerenciamento de Dependências
• Configuração de CI para Rust

Versões da Pilha: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4 e Polars 0.46+.