Spara en version: git commit

Det här lär du dig

• Att spara en version med git commit.
• Vad en commit innehåller.
• Att skriva ett commit-meddelande som går att förstå efteråt.

Varför behövs det här?

I modul 1 sparade du versioner genom att kopiera filer och hitta på nya namn. Med Git är varje version en commit: en ögonblicksbild av projektet med en beskrivning av vad som ändrats, vem som gjorde det och när. Du behöver aldrig mer hitta på filnamn som resplan-slutlig-2.txt.

Så hänger det ihop

git commit tar allt som ligger i staging area och sparar det som en ny version i repositoryt. Varje commit innehåller:

• ögonblicksbilden: hur alla filer i projektet såg ut just då
• meddelandet: din beskrivning av ändringen
• författaren: namnet och e-postadressen du ställde in i modul 2
• tidpunkten
• föregående commit: commiten den bygger på. Det är så historiken hänger ihop.

Git ger varje commit ett unikt id, en lång kombination av siffror och bokstäver som 226c08c117ec…. Oftast räcker de första sju tecknen, 226c08c, för att peka ut den.

Så fungerar det: varför ett id och inte ett nummer?

Id:t räknas ut från commitens innehåll (en så kallad hash). Ändras minsta del av innehållet blir id:t ett helt annat. Därför kan ingen ändra en sparad version i smyg. Id:t skulle inte längre stämma.

Exempel

Med -m skriver du meddelandet direkt i kommandot:

Terminal

$ git commit -m "Första versionen av resplanen"
[main (root-commit) 226c08c] Första versionen av resplanen
 1 file changed, 4 insertions(+)
 create mode 100644 resplan.txt

Git svarar med grenen (main), början på id:t (226c08c) och hur mycket som ändrats: en fil och fyra nya rader. root-commit betyder att det är den allra första commiten i repositoryt.

Efter commiten finns inget kvar att spara:

Terminal

$ git status
On branch main
nothing to commit, working tree clean

Bra commit-meddelanden

Ett bra meddelande säger vad ändringen gör, så att du förstår det om ett halvår:

Mindre bra	Bättre
ändringar	Lägg till dag 3: Gävle
fix	Rätta stavningen av Västerås
asdf	Flytta Uppsala till dag 2

Skriv i imperativ, som en uppmaning: Lägg till, Rätta, Ta bort. Håll första raden kort, gärna under 50 tecken.

Övning

Gör så här: spara två versioner

1. Om du inte redan har gjort det: kör git add resplan.txt och sedan git commit -m "Första versionen av resplanen".
2. Öppna resplan.txt och lägg till raden Dag 3: Gävle. Spara filen.
3. Kör git status. Filen står nu som modified.
4. Kör git add resplan.txt och sedan git commit -m "Lägg till dag 3: Gävle".
5. Kör git status. Det ska stå nothing to commit, working tree clean.

Vanliga problem

Om det inte fungerar: no changes added to commit

Du har ändrat en fil men inte valt ut ändringen. Kör git add <fil> först och sedan git commit igen. Commit sparar bara det som ligger i staging area.

Om det inte fungerar: ett konstigt fönster öppnades när jag skrev git commit

Utan -m öppnar Git en texteditor där du ska skriva meddelandet. Ofta är det Vim, som är svår att ta sig ur för den som inte känner den. Tryck Esc, skriv :q! och tryck Enter. Då avbryts commiten. Kör sedan git commit -m "Ditt meddelande" i stället.

Om det inte fungerar: Author identity unknown / Please tell me who you are

Git vet inte vem du är. Ställ in namn och e-post som i modul 2, med ditt eget namn och din egen adress: git config --global user.name "Ditt Namn" och git config --global user.email "du@example.com".

Testa dig själv

1. Du har ändrat resplan.txt men inte kört git add. Vad sparas om du kör git commit -m "Ny dag"?

• Ingenting – Git säger att inga ändringar är utvalda
• Ändringen i resplan.txt
• Alla filer i mappen

Visa rätt svar

• Ingenting – Git säger att inga ändringar är utvalda: git commit sparar bara det som ligger i staging area.

2. Vilket commit-meddelande är bäst?

• Lägg till dag 3: Gävle
• ändringar
• resplan-slutlig-2

Visa rätt svar

• Lägg till dag 3: Gävle: Det säger exakt vad ändringen gör.

3. Vilket av följande ingår i en commit? (Välj alla som stämmer)

• En ögonblicksbild av filerna
• Författarens namn och e-post
• En hänvisning till föregående commit
• Ditt lösenord till datorn

Visa rätt svar

• En ögonblicksbild av filerna
• Författarens namn och e-post
• En hänvisning till föregående commit

Rätta

Sammanfattning

• git commit -m "meddelande" sparar det som ligger i staging area som en ny version.
• En commit innehåller ögonblicksbilden, meddelandet, författaren, tidpunkten och föregående commit.
• Varje commit har ett unikt id. Oftast räcker de sju första tecknen.
• Ett bra meddelande säger vad ändringen gör, i imperativ: Lägg till dag 3: Gävle.