~ / hub / erros / Conflito de merge no Git — guia completo
27 set 2026errosguia completo

Conflito de merge no Git — guia completo

Ler marcadores, resolver no editor, concluir merge/rebase e o que fazer com lockfiles.

1. Como o conflito aparece

<<<<<<< HEAD
sua versão
=======
versão da outra branch
>>>>>>> feature/login

2. Fluxo seguro

git status
# edite e remova os marcadores
git add caminho/arquivo.js
git commit          # se for merge
# ou, em rebase:
git rebase --continue

3. Abortar se necessário

git merge --abort
git rebase --abort

4. package-lock / yarn.lock

Em conflito de lockfile, escolha uma base consciente e rode de novo npm install (ou equivalente) para regenerar o lock de forma consistente.

DICA VS Code: “Accept Current / Incoming / Both”. Evite push --force em branch compartilhada sem combinar com o time.

5. Listar e escolher um lado inteiro

Para ver só os arquivos em conflito e, se fizer sentido, ficar com a versão de um dos lados em um arquivo específico:

git diff --name-only --diff-filter=U
git checkout --ours   caminho/arquivo.js
git checkout --theirs caminho/arquivo.js
git add caminho/arquivo.js

Atenção: durante um rebase, ours e theirs aparecem invertidos em relação ao merge, porque o Git reaplica os seus commits sobre a outra base. Confira o resultado antes de continuar.

6. Conferir antes de concluir

git diff --check      # aponta marcadores de conflito esquecidos
git diff --staged     # revise o que vai entrar no commit
# rode testes/build do projeto antes do commit final

7. Errei na resolução: como voltar

Se o merge já foi concluído e você quer desfazê-lo, git reset --hard ORIG_HEAD volta ao estado anterior ao merge (use apenas se não houver trabalho não commitado a preservar). Para qualquer outro caso, git reflog mostra onde o HEAD esteve e permite recuperar um commit.

8. Como reduzir conflitos

  • Faça commits pequenos e integre a branch principal com frequência.
  • Use git pull --rebase se o time adota histórico linear.
  • Combine quem mexe em arquivos muito compartilhados (lockfiles, configs, arquivos gerados).

Para entender o fluxo de branches por trás disso, veja Git em produção, o módulo de colaboração do curso Git e o roadmap de Git.

← erros · curso Git: branches

Quer aplicar isso no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar diagnóstico →