Como funciona a mesclagem no Git?

Question

Accepted Answer

**Mesclagem** combina alterações de uma branch em outra — tipicamente trazendo uma branch de feature concluída de volta para a branch principal. O Git lida com a maioria das mesclagens automaticamente, mas entender os tipos de mesclagem e **conflitos** é importante. ## Mesclagem básica ```bash git switch main # be on the branch you want to merge INTO git merge feature-x # merge feature-x's changes into main ``` Você muda para a branch **destino** (aquela que recebe as alterações) e mescla a branch **origem** nela. ## Fast-forward vs merge commit ```text FAST-FORWARD merge → if main hasn't changed since the branch was created, Git just MOVES main's pointer forward to the branch's latest commit (no merge commit, linear) MERGE COMMIT (three-way merge) → if BOTH branches have new commits, Git creates a new "merge commit" combining them (has two parents) → preserves that a merge happened → git merge --no-ff forces a merge commit even when fast-forward is possible ``` O Git faz fast-forward quando possível (simplesmente avançando o ponteiro) ou cria um **merge commit** (com dois pais) quando ambas as branches divergiram. ## Conflitos de mesclagem ```text A CONFLICT happens when both branches changed the SAME lines differently — Git can't auto-decide which to keep, so it asks YOU to resolve: ``` ```text <<<<<<< HEAD the version from the current branch (main) ======= the version from the branch being merged (feature-x) >>>>>>> feature-x ``` ```bash # resolve: edit the file to the desired result, remove the markers, then: git add # mark the conflict resolved git commit # complete the merge # git merge --abort # or cancel the merge entirely ``` **Conflitos** ocorrem quando ambas as branches alteraram as mesmas linhas — Git as marca e você escolhe manualmente o resultado correto, depois faz stage e commit. ## Por que isso importa Entender mesclagem é essencial porque combinar alterações de branches é uma parte fundamental e constante de fluxos de trabalho colaborativos no Git, então saber como funciona (incluindo conflitos) é conhecimento necessário do dia a dia. **Mesclagem** é como o trabalho concluído (tipicamente branches de feature) é integrado de volta à branch principal — o ato rotineiro de reunir alterações que acontece continuamente no desenvolvimento em equipe. Entender a diferença entre um **fast-forward merge** (Git simplesmente avançando o ponteiro quando o destino não divergiu, mantendo o histórico linear) e um **merge commit** (uma mesclagem de três vias criando um novo commit com dois pais quando ambas as branches têm novos commits, registrando que uma mesclagem aconteceu) esclarece como o Git integra alterações e como o histórico resultante fica. Mais importante ainda, entender **conflitos de mesclagem** — que ocorrem quando ambas as branches alteraram as mesmas linhas de forma diferente, então o Git não consegue decidir automaticamente e pede que você resolva — é conhecimento prático crucial: conflitos são uma parte normal e inevitável da colaboração, e saber como reconhecer os marcadores de conflito (`<<<<<<<`, `=======`, `>>>>>>>`), editar o arquivo para o resultado correto e completar a mesclagem (fazer stage e commit) é uma habilidade essencial que frequentemente é fonte de ansiedade para quem não entende. Já que integrar alterações de branches por meio de mesclagem é fundamental e constante no desenvolvimento colaborativo, e já que entender tipos de mesclagem e especialmente resolver conflitos é necessário para combinar o trabalho corretamente (uma tarefa rotineira e inevitável), entender como funciona a mesclagem — mesclagens básicas, fast-forward vs merge commits e resolução de conflitos — é conhecimento Git essencial e frequentemente aplicado, uma habilidade central para colaboração onde a resolução de conflitos em particular é uma necessidade prática que todo desenvolvedor deve lidar com confiança.