نمایش وضعیت درخت کاری

پیش‌نمایش دستور

            

استفاده

git status [گزینه‌ها]

مثال‌ها

git status                # Show status of working tree
git status -s             # Show status in short format
git status -b             # Show branch information
git status -u no          # Show no untracked files

گزینه‌ها

  • -s : فرمت خلاصه
  • -b : نمایش اطلاعات شاخه
  • -u : نمایش فایل‌های غیر رهگیری شده

دقیقاً چه می‌کند؟

دستور git status وضعیت فعلی دایرکتوری کاری و ناحیه استیجینگ را نمایش می‌دهد. این دستور به شما می‌گوید که کدام تغییرات آماده‌ی کامیت هستند، کدام فایل‌ها تغییر کرده‌اند اما آماده‌ی کامیت نشده‌اند و کدام فایل‌ها غیر رهگیری شده‌اند.

موارد کاربرد رایج

  • برای بررسی اینکه کدام فایل‌ها تغییر کرده‌اند و آیا آن‌ها برای کامیت آماده هستند یا نه.
  • برای مشاهده‌ی اطلاعات شاخه‌ای که در حال کار روی آن هستید و بررسی اینکه آیا شاخه از شاخه‌ی ریموت جلوتر، عقب‌تر یا جدا شده است.
  • برای دیدن فایل‌های غیر رهگیری شده که هنوز به گیت اضافه نشده‌اند.

مقایسه با دستورات دیگر گیت

ویژگی git status git diff
هدف نمایش وضعیت فعلی دایرکتوری کاری و ناحیه استیجینگ نمایش تفاوت‌ها بین دایرکتوری کاری و ایندکس (یا بین کامیت‌ها)
اثر نمایش فایل‌های تغییر کرده، آماده کامیت شده، یا غیر رهگیری شده نمایش تغییرات خط به خط در فایل‌ها
جزئیات خلاصه‌ای از وضعیت مخزن نمایش تغییرات دقیق انجام‌شده در فایل‌ها

به زبان ساده

دستور git status یک نمای کلی از وضعیت مخزن شما است. این دستور به شما می‌گوید که کدام تغییرات آماده‌ی کامیت هستند، کدام فایل‌ها تغییر کرده‌اند اما هنوز کامیت نشده‌اند و کدام فایل‌ها به گیت اضافه نشده‌اند.

اشتباهات رایج

  • مبهم بودن تفاوت بین فایل‌های آماده‌ی کامیت و فایل‌های تغییر کرده که هنوز استیج نشده‌اند. برای بررسی تغییرات دقیق‌تر از دستور git diff استفاده کنید.
  • فراموش کردن اینکه فایل‌های غیر رهگیری شده هنوز تحت کنترل نسخه قرار نگرفته‌اند و باید با git add به گیت اضافه شوند.
  • گمان اینکه خروجی دستور git status تفاوت‌های ریموت را هم نشان می‌دهد. برای این کار باید از git fetch و سپس از git status استفاده کنید.

بهترین شیوه‌ها

  • به‌طور مرتب از دستور git status برای پیگیری وضعیت تغییرات خود استفاده کنید.
  • قبل از کامیت کردن، حتماً وضعیت را بررسی کنید تا مطمئن شوید که همه‌ی فایل‌های لازم استیج شده‌اند و در شاخه‌ی درستی هستید.
  • در مخزن‌های بزرگ که فایل‌های زیادی تغییر کرده‌اند، از git status -s برای نمایش وضعیت به صورت خلاصه استفاده کنید.

محدودیت‌ها

  • دستور git status تغییرات محتویات فایل‌ها را نشان نمی‌دهد. برای این کار از دستور git diff استفاده کنید.
  • این دستور فقط فایل‌های غیر رهگیری شده را نشان می‌دهد و اطلاعات بیشتری در مورد علت نادیده گرفتن فایل‌ها ارائه نمی‌دهد.

نحوه استفاده

به سادگی دستور

git status
را اجرا کنید تا وضعیت فعلی دایرکتوری کاری خود را مشاهده کنید. برای مشاهده نمای خلاصه از گزینه -s استفاده کنید. اگر نیاز به مشاهده اطلاعات شاخه دارید، از گزینه -b استفاده کنید.

نمای کلی

دستور git status ابزاری است که وضعیت فعلی دایرکتوری کاری شما را نشان می‌دهد. این دستور به شما کمک می‌کند تا بفهمید که چه فایل‌هایی تغییر کرده‌اند، چه فایل‌هایی آماده کامیت هستند و کدام فایل‌ها هنوز تحت کنترل گیت قرار نگرفته‌اند.

گزینه‌ها

  • -s : فرمت خلاصه، نمایش تغییرات به صورت فشرده
  • -b : نمایش شاخه جاری و وضعیت آن نسبت به شاخه ریموت
  • -u : نمایش فایل‌های غیر رهگیری شده (یا عدم نمایش آن‌ها)