2.6 Grunderna i Git - Att tagga

Att lista taggar i Git är enkelt. Skriv bara git tag (med valfria -l eller --list):

Kommandot listar taggarna i alfabetisk ordning; ordningen är inte särskilt viktig.

Du kan också söka efter taggar som matchar ett visst mönster. Gits källkodskodförråd innehåller till exempel fler än 500 taggar. Om du bara är intresserad av serien 1.8.5 kan du köra:

Git stödjer två typer av taggar: lättviktiga och kommenterade.

En lättviktig tagg är ungefär som en gren som aldrig flyttar sig – den är bara en pekare till en viss incheckning.

Annoterade taggar lagras däremot som fullvärdiga objekt i Git-databasen. De får en kontrollsumma, innehåller taggarens namn, e-post och datum, har ett taggmeddelande och kan signeras och verifieras med GNU Privacy Guard (GPG). Det rekommenderas i regel att du skapar annoterade taggar för att få all denna information; men om du vill ha en tillfällig tagg eller inte vill spara den extra informationen finns lättviktiga taggar.

Att skapa en annoterad tagg i Git är enkelt. Det lättaste är att ange -a när du kör git tag:

Flaggan -m anger taggmeddelandet som sparas tillsammans med taggen. Om du inte anger ett meddelande för en annoterad tagg startar Git din textredigerare så att du kan skriva in det.

Du kan se taggdata tillsammans med incheckningen som taggades genom git show:

Det visar taggarens information, datumet då incheckningen taggades och taggmeddelandet innan incheckningen visas.

Ett annat sätt att tagga incheckningar är en lättviktig tagg. Det är i praktiken bara kontrollsumman för incheckningen lagrad i en fil – ingen annan information lagras. För att skapa en lättviktig tagg utelämnar du -a, -s och -m och anger bara ett taggnamn:

Om du den här gången kör git show på taggen ser du ingen extra tagginformation. Kommandot visar bara incheckningen:

Du kan också tagga incheckningar i efterhand. Anta att din historik ser ut så här:

Anta att du glömde tagga projektet vid v1.2, som låg på incheckningen "Update rakefile". Du kan lägga till den i efterhand. För att tagga den incheckningen anger du kontrollsumman (eller en del av den) i slutet av kommandot:

Du kan se att incheckningen är taggad:

Som standard skickar git push inte taggar till fjärrservrar. Du måste uttryckligen skicka taggar efter att du skapat dem. Processen är densamma som för fjärrgrenar – du kan köra git push origin <taggnamn>.

Om du har många taggar du vill skicka samtidigt kan du ange --tags till git push. Detta skickar alla dina taggar som ännu inte finns på servern.

Nu, om någon annan klonar eller hämtar data från fjärrkodförrådet får de med dina taggar.

För att ta bort taggar i ditt lokala kodförråd använder du git tag -d <taggnamn>. Du kan till exempel ta bort vår lättviktiga tagg så här:

Notera att detta inte tar bort taggen från några fjärrkodförråd. Det finns två vanliga sätt att ta bort taggar från fjärrkodförråd.

Det första är git push <fjärrnamn> :refs/tags/<taggnamn>:

Ovanstående tolkas som att null-värdet före kolon skickas till serverns taggnamn, vilket i praktiken tar bort taggen.

Det andra (och mer intuitiva) sättet att ta bort en tagg i fjärrkodförrådet är:

Om du vill se versionen av filerna som en tagg pekar på kan du köra git checkout på taggen. Ditt kodförråd hamnar då i tillståndet "detached HEAD", vilket har några bieffekter:

I "frikopplad HEAD"-läget kan du göra ändringar och spara incheckningar som vanligt, men taggen flyttas inte och dina incheckningar tillhör ingen gren och blir därför i praktiken svåra att nå, förutom via sina kontrollsummor. Om du vill göra ändringar – till exempel åtgärda ett programfel i en gammal version – bör du skapa en gren:

Om du gör detta och sedan checkar in kommer grenen version2 att skilja sig från taggen v2.0.0 eftersom den flyttar sig framåt med dina ändringar, så var försiktig.