نمایش شئ گیت

استفاده

git show [گزینه‌ها] [شیء]

مثال‌ها

git show 1234abcd         # Show a commit by its hash
git show HEAD             # Show the latest commit
git show --stat           # Show commit with stat
git show --name-only      # Show files changed in the commit

گزینه‌ها

• --stat : نمایش commit همراه با آمار تغییرات فایل‌ها
• --name-only : نمایش فقط نام فایل‌های تغییر یافته
• --name-status : نمایش نام فایل‌ها همراه با وضعیت (اضافه شده، ویرایش شده، حذف شده)
• --patch : نمایش patch (diff) برای commit
• --pretty= : سفارشی‌سازی فرمت پیام commit

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

دستور git show برای نمایش اطلاعات مربوط به یک شیء گیت خاص (commit، branch، یا tag) استفاده می‌شود که با هش منحصر به فرد خود شناسایی می‌شود. این دستور بیشتر برای مشاهده جزئیات یک commit، از جمله فایل‌های تغییر یافته، پیام commit و تغییرات انجام شده (diff) استفاده می‌شود.

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

• مشاهده جزئیات یک commit خاص با استفاده از هش آن.
• مشاهده اطلاعات آخرین commit.
• بررسی تغییرات اعمال شده در یک commit (diff).
• بررسی سریع نام فایل‌های تغییر یافته در یک commit.

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

• استفاده از --stat برای مشاهده سریع آمار تغییرات در commit.
• استفاده از --name-only زمانی که فقط به نام فایل‌های تغییر یافته نیاز دارید.
• استفاده از --patch زمانی که می‌خواهید تغییرات دقیق در commit را مشاهده کنید.
• استفاده از --pretty= برای سفارشی‌سازی فرمت نمایش پیام commit.

محدودیت‌ها

• این دستور تنها اطلاعات مربوط به یک شیء گیت (مثلاً یک commit، branch یا tag) را نمایش می‌دهد.
• این دستور هیچ‌گونه تغییری در فایل‌ها یا commits موجود در مخزن ایجاد نمی‌کند؛ فقط اطلاعات را نمایش می‌دهد.

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

• فراموش کردن تعیین یک شیء گیت معتبر (مثل هش commit یا نام شاخه) منجر به خطا خواهد شد.
• استفاده از فرمت نادرست برای گزینه --pretty می‌تواند باعث خروجی غیرمنتظره شود.

نمای کلی

دستور git show ابزاری بسیار مفید برای نمایش اطلاعات دقیق درباره اشیاء گیت مختلف است. این دستور به ویژه برای مشاهده تاریخچه commitها و تغییرات اعمال شده در فایل‌ها کاربرد دارد.