git-status - Visar statusen för arbetskatalogen

Visar sökvägar som har skillnader mellan indexfilen och den aktuella HEAD-incheckningen, sökvägar som har skillnader mellan arbetskatalog och indexfilen, och sökvägar i arbetskatalog som inte spåras av Git (och inte ignoreras av gitignore[5]). De första är vad du skulle checka-in genom att köra git commit; den andra och tredje är vad du skulle kunna checka-in genom att köra git add innan du kör git commit.

Utdata från det här kommandot är utformat för att användas som en kommentar i en inchecknings-mall. Standardformatet, det långa, är utformat för att vara människoläsbart, utförligt och beskrivande. Dess innehåll och format kan ändras när som helst.

Sökvägarna som nämns i utdata, till skillnad från många andra Git-kommandon, skapas relativa till den aktuella katalogen om du arbetar i en underkatalog (detta är avsiktligt för att underlätta klippning och klistring). Se konfigurationsalternativet status.relativePaths nedan.

The command honors color.status (or status.color — they mean the same thing and the latter is kept for backward compatibility) and color.status.<slot> configuration variables to colorize its output.

Om konfigurationsvariabeln status.relativePaths är satt till falskt, är alla visade sökvägar relativa till förvars-roten, inte till den aktuella katalogen.

Om status.submoduleSummary är satt till ett tal som inte är noll eller sant (identiskt med -1 eller ett obegränsat tal), kommer undermodulsammanfattningen att aktiveras för det långa formatet och en sammanfattning av incheckningar för modifierade undermoduler kommer att visas (se alternativet --summary-limit i git-submodule[1]). Observera att sammanfattningsutdata från kommandot status kommer att undertryckas för alla undermoduler när diff.ignoreSubmodules är satt till all eller endast för de undermoduler där submodule.<namn>.ignore=all. För att även visa sammanfattningen för ignorerade undermoduler kan du antingen använda kommandoradsalternativet --ignore-submodules=dirty eller kommandot git submodule summary, som visar en liknande utdata men inte respekterar dessa inställningar.

Som standard uppdaterar git status automatiskt indexet, uppdaterar den cachade statistikinformationen från arbetskatalogen och skriver ut resultatet. Att skriva ut det uppdaterade indexet är en optimering som inte är absolut nödvändig (status beräknar värdena för sig själv, men att skriva ut dem är bara för att rädda efterföljande program från att upprepa vår beräkning). När status körs i bakgrunden kan låset som hålls under skrivningen komma i konflikt med andra samtidiga processer, vilket kan orsaka att de misslyckas. Skript som kör status i bakgrunden bör överväga att använda git --no-optional-locks status (se git[1] för detaljer).

git status kan vara väldigt långsamt i stora arbetsträd om/när det behöver söka efter filer och kataloger som inte spåras. Det finns många konfigurationsalternativ tillgängliga för att påskynda detta genom att antingen undvika arbetet eller använda cachade resultat från tidigare Git-kommandon. Det finns ingen optimal uppsättning inställningar som är rätt för alla. Vi listar en sammanfattning av de relevanta alternativen för att hjälpa dig, men innan du går in på listan kanske du vill köra git status igen, eftersom din konfiguration kanske redan cachar git status-resultat, så det kan vara snabbare vid efterföljande körningar.

Observera att efter att du har aktiverat den ospårade cachen och/eller FSMonitor-funktionerna kan det ta några git status-kommandon för de olika cachen att värmas upp innan du ser förbättrade kommandotider. Detta är normalt.

gitignore[5]

En del av git[1]-sviten