Slå ihop: git merge

Det här lär du dig

• Att föra in en gren i main med git merge.
• Skillnaden mellan en fast-forward och en merge-commit.
• Att ta bort en gren som du är klar med, med git branch -d.

Varför behövs det här?

En grengrenBranchEn egen utvecklingslinje i ett repository, där man kan göra ändringar utan att påverka huvudversionen.Läs mer om gren är till för att arbeta ifred. Men när arbetet är klart ska det in i huvudversionen, annars blir det aldrig en del av resplanen. Att föra ihop två grenar kallas att göra en mergemergeMergeAtt föra ihop ändringarna från två branches till en. Git gör det automatiskt när det går och ber om hjälp när samma rader ändrats på olika sätt.Läs mer om merge, på svenska slå ihop eller sammanfoga.

Så hänger det ihop

Du gör alltid en merge från den gren du står på. git merge dag-4 betyder: för in det som finns på dag-4 i grenen jag står på nu. Vill du föra in dag-4 i main växlar du därför först till main.

Git gör en merge på ett av två sätt:

• Fast-forward (spola framåt): har main inte fått några nya commits sedan grenen skapades, behöver Git bara flytta fram main till samma commitcommitCommitEn sparad version av projektet i Git, med en beskrivning av vad som ändrats, vem som gjorde det och när.Läs mer om commit som grenen. Ingen ny commit skapas.
• Merge-commit: har båda grenarna fått nya commits sedan de delade sig, skapar Git en ny commit som för ihop dem. Den är speciell, eftersom den har två föregående commits, en från varje gren.

Du väljer inte själv vilket sätt det blir. Git ser hur historiken ser ut och gör det som behövs.

Exempel

Fast-forward

Grenen dag-4 har en ny commit, men main har inte ändrats. Växla till main och gör en merge:

Terminal

$ git switch main
Switched to branch 'main'
$ git merge dag-4
Updating 7620fac..8923e85
Fast-forward
 resplan.txt | 1 +
 1 file changed, 1 insertion(+)

Fast-forward betyder att main bara flyttades fram från 7620fac till 8923e85. Nu pekar båda grenarna på samma commit:

Terminal

$ git log --oneline
8923e85 (HEAD -> main, dag-4) Lägg till dag 4: Sundsvall
7620fac Lägg till dag 3: Gävle
226c08c Första versionen av resplanen

Grenen dag-4 behövs inte längre. Ta bort den:

Terminal

$ git branch -d dag-4
Deleted branch dag-4 (was 8923e85).

Det är bara etiketten som tas bort. Commiten 8923e85 finns kvar i historiken för main.

Merge-commit

Nu har du skapat grenen packlista och lagt till filen packlista.txt där. Under tiden har du också gjort en commit på main, som lägger till ett årtal i rubriken. Grenarna har gått isär:

Terminal

$ git log --oneline --all --graph
* dba7ce7 (HEAD -> main) Lägg till årtal i rubriken
| * b8c5496 (packlista) Lägg till packlista
|/
* 8923e85 Lägg till dag 4: Sundsvall
* 7620fac Lägg till dag 3: Gävle
* 226c08c Första versionen av resplanen

Stå på main och gör en merge:

Terminal

git merge packlista

Git behöver ett meddelande till den nya merge-commiten och öppnar därför en texteditor, med ett meddelande som redan är ifyllt: Merge branch 'packlista'. Spara och stäng editorn. Är det Vim, skriv :wq och tryck Enter. Sedan skriver Git:

Terminal

Merge made by the 'ort' strategy.
 packlista.txt | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 packlista.txt

Vill du slippa editorn och använda det ifyllda meddelandet direkt, skriv git merge --no-edit packlista.

Längst till vänster i utskriften syns nu hur de två grenarna går ihop igen i merge-commiten:

Terminal

$ git log --oneline --graph
*   32d3823 (HEAD -> main) Merge branch 'packlista'
|\
| * b8c5496 (packlista) Lägg till packlista
* | dba7ce7 Lägg till årtal i rubriken
|/
* 8923e85 Lägg till dag 4: Sundsvall
* 7620fac Lägg till dag 3: Gävle
* 226c08c Första versionen av resplanen

main har nu både årtalet och packlistan.

Så fungerar det: vad betyder 'ort'?

ort är namnet på det sätt Git räknar ut sammanslagningen på. Det är standard sedan Git 2.34, och du behöver inte välja något själv. I äldre versioner står det recursive i stället.

Övning

Gör så här: för in två grenar i main

1. Stå i resplan-git. Växla till main och för in grenen från förra lektionen: git switch main och git merge dag-4. Git ska skriva Fast-forward.
2. Ta bort grenen: git branch -d dag-4.
3. Skapa en ny gren: git switch -c packlista. Skapa filen packlista.txt med några saker du vill ta med, och gör en commit.
4. Växla till main. Ändra rubriken i resplan.txt och gör en commit.
5. Kör git log --oneline --all --graph och se hur grenarna har gått isär.
6. För in packlistan: git merge --no-edit packlista. Nu ska Git skriva Merge made by the ‘ort’ strategy.
7. Kör git log --oneline --graph igen. Kontrollera att både packlista.txt och den nya rubriken finns på main.
8. Ta bort grenen packlista.

Vanliga problem

Om det inte fungerar: Already up to date

Det finns inget att föra in: allt på grenen finns redan där du står. Kontrollera att du står på rätt gren med git branch, och att du skrev rätt gren efter git merge. Har du kanske växlat åt fel håll, och står på grenen i stället för på main?

Om det inte fungerar: error: the branch … is not fully merged

git branch -d vägrar ta bort en gren med commits som inte finns någon annanstans. Då skulle arbetet försvinna. Har du glömt git merge? Gör den först. Är du säker på att du vill kasta arbetet på grenen kan du skriva git branch -D <namn>, med stort D. Det går inte att ångra på ett enkelt sätt.

Om det inte fungerar: ett editorfönster öppnades och jag kommer inte ut

Git vill ha ett meddelande till merge-commiten. Meddelandet är redan ifyllt. I Vim: tryck Esc, skriv :wq och tryck Enter. I nano: tryck Ctrl+O, Enter och sedan Ctrl+X. Nästa gång kan du skriva git merge --no-edit <gren>.

Testa dig själv

1. Du vill föra in grenen dag-4 i main. Vad gör du?

• git switch main och sedan git merge dag-4
• git switch dag-4 och sedan git merge main
• git branch -d dag-4

Visa rätt svar

• git switch main och sedan git merge dag-4: git merge för in den angivna grenen i den gren du står på.

2. Git skriver "Fast-forward" efter git merge. Vad har hänt?

• main har flyttats fram till grenens senaste commit, och ingen ny commit har skapats
• Git har skapat en merge-commit med två föregångare
• Sammanslagningen misslyckades

Visa rätt svar

• main har flyttats fram till grenens senaste commit, och ingen ny commit har skapats: Det händer när main inte har fått några nya commits sedan grenen skapades.

3. Du har gjort git merge dag-4 och sedan git branch -d dag-4. Vad händer med commitsen från dag-4?

• De finns kvar i historiken för main
• De försvinner

Visa rätt svar

• De finns kvar i historiken för main: Bara etiketten dag-4 tas bort. Commitsen är redan en del av main.

Rätta

Sammanfattning

• git merge <gren> för in grenen i den gren du står på. Växla till main först.
• Fast-forward: main flyttas bara fram. Det händer när main inte har ändrats sedan grenen skapades.
• Merge-commit: en ny commit med två föregångare. Det händer när båda grenarna har nya commits.
• git branch -d <gren> tar bort en gren som är införd. Commits som finns i main försvinner inte.