Se läget och välja ändringar: git status och git add

Det här lär du dig

Att läsa av läget i repositoryt med git status.
Skillnaden mellan en ospårad fil och en ändrad fil.
Att välja ut ändringar till nästa version med git add, och att ångra valet.

Varför behövs det här?

git status är det kommando du kommer att köra oftast. Det ändrar ingenting, utan visar bara läget. När du är osäker på vad som händer är git status alltid ett bra första steg.

Så hänger det ihop

Git delar in filerna i arbetskatalogen i tre grupper:

Ospårade filer (untracked): filer som Git ser men aldrig har sparat. Git rör dem inte förrän du ber om det.
Ändrade filer (modified): filer som Git har sparat förut och som nu ser annorlunda ut.
Oförändrade filer: allt annat. Dem visar git status inte alls.

Med git add flyttar du en ny eller ändrad fil till staging area. Då hamnar den under rubriken Changes to be committed, alltså ändringar som kommer med i nästa version.

Exempel

I ett nytt repository utan filer säger git status att det inte finns något att spara:

$ git status
On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

Skapa filen resplan.txt i projektmappen med en texteditor. Nu ser Git en ospårad fil:

$ git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
  resplan.txt

nothing added to commit but untracked files present (use "git add" to track)

Välj ut filen med git add. Nu ligger den i staging area, redo att sparas:

$ git add resplan.txt
$ git status
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
  new file:   resplan.txt

Övning

Skriv filen i en vanlig texteditor:

Använd Anteckningar (Notepad). Spara som resplan.txt i projektmappen.

Vill du ångra ett git add innan du sparar en version? Då flyttar du tillbaka ändringen från staging area. Själva ändringen i filen finns kvar:

git restore --staged resplan.txt

Vanliga problem

Testa dig själv

1. Du skapar en helt ny fil i projektmappen. Hur visar git status den?

Under "Untracked files"
Under "Changes to be committed"
Den syns inte alls

Visa rätt svar

Under "Untracked files": Git har aldrig sparat filen, så den är ospårad.

2. Vad händer med filen när du kör git status?

Ingenting – git status visar bara läget
Filen sparas som en ny version
Filen flyttas till staging area

Visa rätt svar

Ingenting – git status visar bara läget

3. Du råkade köra git add på fel fil. Vilket kommando flyttar tillbaka den från staging area utan att ändra innehållet?

git restore --staged <fil>
git commit
git status

Visa rätt svar

git restore --staged <fil>: Ändringen finns kvar i filen, men är inte längre utvald till nästa version.

Sammanfattning

git status visar läget och ändrar ingenting. Kör det ofta.
Ospårad fil: Git har aldrig sparat den. Ändrad fil: den har ändrats sedan den senast sparades.
git add <fil> flyttar en ändring till staging area. git restore --staged <fil> flyttar tillbaka den.