فصل 3 عملیات‌های گیت درس 13 از 16

آموزش گیت - عملیات 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) شما چگونه است.

پیشرفت مطالعه: وضعیت خوانده‌شدن این درس فقط در همین مرورگر ذخیره می‌شود؛ بدون نیاز به حساب کاربری.