آموزش گیت - عملیات Status
دستور git status وضعیت دایرکتوری کاری ما را نمایش میدهد.
خروجی git status نشان میدهد که HEAD در هر لحظه کجا قرار دارد (روی یک branch یا commit). این دستور اطلاعات زیر را ارائه میدهد:
-
Untracked files - فایلهایی را نشان میدهد که توسط Git ردیابی نمیشوند، اما در دایرکتوری کاری شما قرار دارند.
-
Changes to be committed - دستور git status نشان میدهد که آیا تغییرات با قرار گرفتن در حالت staged یا اضافه شدن به index برای commit بعدی آماده شدهاند یا خیر.
-
Changes not staged for commit - تغییراتی که در فایلها ایجاد شدهاند و تغییر کردهاند اما هنوز در حالت staged قرار نگرفتهاند.
-
این دستور اطلاعاتی درباره ارتباط شاخه محلی فعلی با معادل ریموت آن ارائه میدهد، از جمله اینکه چقدر جلوتر یا عقبتر است.
-
Branch information - دستور git status شاخه فعلی و وضعیت ردیابی (tracking state) آن را نشان میدهد.
-
Shows conflicts - دستور git status در زمان بروز تعارض ادغام (merge conflict) نشان میدهد کدام فایلها دچار تعارض هستند.
-
Variation in paths - مسیرهایی که بین commit فعلی HEAD و فایل index تفاوت دارند، توسط git status نمایش داده میشوند.
-
مسیرهایی را نشان میدهد که بین فایل index و درخت کاری (working tree) تفاوت دارند و نشاندهنده تغییراتی هستند که میتوان با استفاده از git add در حالت staged قرار داد.
-
علاوه بر این، این دستور مسیرهای درخت کاری را نشان میدهد که میتوان با git add اضافه کرد و سپس در حالت staged قرار داد و commit کرد، به شرطی که توسط .gitignore نادیده گرفته نشده باشند یا توسط Git ردیابی نشوند.
Syntax
نحو (سینتکس) دستور git status به صورت زیر است:
git status
Options
دستور git status گزینههای زیر را دارد:
Short Output
گزینه -s یا --short در Git خروجی برخی دستورها (مانند git status) را تغییر میدهد تا فرمتی کوتاه و خلاصه ارائه دهد که اطلاعات مهم را به شکلی فشرده برجسته میکند.
git status -s
git status --short
Branch Information
گزینه -b یا --branch در Git خروجی فرمت کوتاه را با افزودن جزئیاتی درباره شاخه فعال و وضعیت ردیابی آن بهبود میبخشد و زمینه بیشتری به نمایشهای مختصر میدهد.
git status -b
git status --branch
Porcelain Output
Git دستورها و خروجیهایی ارائه میدهد که کاربرپسند هستند و بهطور خاص برای کاربران نهایی طراحی شدهاند. دستور git status --porcelain خروجی مختصری میدهد که تجزیه و تحلیل آن آسان است.
git status --porcelain
Show Stashed Changes
تعداد مواردی که در حال حاضر در stash نگهداری میشوند، توسط گزینه --show-stash در Git نمایش داده میشود که نشان میدهد چند مجموعه از تغییرات بهطور موقت در stash ذخیره شدهاند.
git status --show-stash
Long Output
وقتی دستوری در Git با گزینه --long اجرا شود، بهطور خودکار خروجیای تولید میکند که پرجزئیات و توصیفی است.
git status --long
Detailed Output
گزینه -v یا --verbose در Git هم نام فایلهایی را که ویرایش شدهاند و برای commit آماده هستند نمایش میدهد و هم تغییرات متنیِ در حالت staged را.
وقتی دو بار استفاده شود (-vv)، تغییرات موجود در درخت کاری را که هنوز در حالت staged قرار نگرفتهاند نیز نشان میدهد؛ مشابه خروجی git diff --cached و git diff.
git status --v
git status --verbose
Control Untracked Files Display
فایلهای ردیابینشده را میتوان با گزینه --untracked-files کنترل کرد. حالتهای مختلفی که میتوان با این دستور بهکار برد به شرح زیر است:
no - هیچ فایل ردیابینشدهای نمایش داده نخواهد شد.
git status --untracked-files=no
normal - این حالت پیشفرض با --untracked-files است.
git status --untracked-files=normal
all - همه فایلهای ردیابینشده را نمایش میدهد.
git status --untracked-files=all
Ignore Submodules
--ignore-submodules[=<when>]
هنگام بررسی تغییرات در زیرماژولها (submodules)، میتوان سطح جزئیاتی را که در خروجی لحاظ میشود انتخاب کرد.
گزینهها به شرح زیر است:
-
none- اگر یک زیرماژول شامل فایلهای ردیابینشده یا بهروزرسانیشده باشد، یا HEAD آن با commit ثبتشده در پروژه اصلی (superproject) مغایرت داشته باشد، تغییریافته محسوب میشود.
-
untracked- اگر یک زیرماژول منحصراً حاوی فایلهای ردیابینشده باشد، همچنان بهروزرسانیها را بررسی میکند اما آنها را نادیده میگیرد.
-
dirty- فقط بهروزرسانیهای مربوط به commitهای ثبتشده در پروژه اصلی را نمایش میدهد و هرگونه تغییر ایجادشده در درخت کاری زیرماژول را نادیده میگیرد.
-
all- خلاصه زیرماژولها را در خروجی مخفی نگه میدارد و همه تغییرات زیرماژولها را پنهان میکند. این مقدار پیشفرض است.
git status --ignore-submodules=all
Show Ignored Files
--ignored[=<mode>]
نمایش فایلهای نادیدهگرفتهشده را میتوان با استفاده از گزینه --ignored[=<mode>] تنظیم کرد. مقدار پیشفرض برای پارامتر اختیاری mode برابر با traditional است.
حالتهایی که میتوانیم استفاده کنیم به شرح زیر است:
-
traditional - مگر اینکه از --untracked-files=all استفاده شود، فایلها و دایرکتوریهای نادیدهگرفتهشده نمایش داده میشوند.
در چنین حالتی، فایلهای نادیدهگرفتهشده داخل دایرکتوریهای نادیدهگرفتهشده نمایش داده میشوند.
-
no - هیچ فایلی بهعنوان نادیدهگرفتهشده نمایش داده نمیشود.
-
matching - دایرکتوریها و فایلهای نادیدهگرفتهشدهای را که با الگوی نادیده گرفتن مطابقت دارند نمایش میدهد.
اگر یک دایرکتوری مطابقت داشته باشد نمایش داده میشود، اما محتویات آن در صورتی که نادیده گرفته شده باشند نمایش داده نمیشوند.
-
محتویات یک دایرکتوری حتی اگر خود دایرکتوری نمایش داده نشود، در صورتی که همه محتویات آن نادیده گرفته شده باشند نمایش داده میشوند.
git status --ignored
Combination of Options
میتوان بیش از یک گزینه را بهطور همزمان بهکار برد تا خروجی را بر اساس نیازهای خود سفارشیسازی کنید. برای مثال، میتوانید از -s و -b استفاده کنید تا وضعیت کوتاه را همراه با اطلاعات شاخه دریافت کنید.
git status -s -b
در مجموع، دستور git status به شما کمک میکند بفهمید چه تغییراتی ایجاد شده است، چه چیزهایی باید در حالت staged قرار گیرند یا commit شوند، و وضعیت کلی مخزن (repository) شما چگونه است.
پیشرفت مطالعه: وضعیت خواندهشدن این درس فقط در همین مرورگر ذخیره میشود؛ بدون نیاز به حساب کاربری.