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

آموزش گیت - عملیات Diff

دستور git diff در گیت تحلیل دقیقی از تغییرات در وضعیت‌ها و آبجکت‌های مختلف مخزن ارائه می‌دهد؛ از جمله درخت کاری (working trees)، ایندکس‌ها (indexes)، درخت‌ها (trees)، نتایج ادغام (merge results)، آبجکت‌های blob و فایل‌های روی دیسک.

این دستور بینش جامعی نسبت به تفاوت‌ها فراهم می‌کند و به همین دلیل برای درک و مدیریت مؤثر کنترل نسخه ضروری است.

دستور git diff یک دستور انعطاف‌پذیر در گیت است که:

  • تغییرات ایجادشده در ایندکس و درخت کاری را نشان می‌دهد.

  • تفاوت‌های بین یک ایندکس و یک درخت مشخص (مانند HEAD) را نمایش می‌دهد.

  • تفاوت‌های بین دو درخت مختلف را بررسی می‌کند.

  • تفاوت‌های بین نتایج یک ادغام را نمایش می‌دهد.

  • فایل‌های تکی یا آبجکت‌های blob را روی دیسک با هم مقایسه می‌کند.

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

git diff [<options>] [--] [<path>]
  • دستور git diff [<options>] [--] [<path>...] به ما امکان می‌دهد تغییرات را نسبت به ناحیه استیجینگ (staging area) یا همان ایندکس ببینیم و تغییراتی را نمایش می‌دهد که هنوز برای کامیت پیش رو استیج نشده‌اند.

  • این تفاوت‌ها، تغییراتی را نشان می‌دهند که می‌توان با git add به ایندکس اضافه کرد.

git diff [<options>] --no-index [--] <path> <path>
  • از استفاده از ایندکس گیت صرف‌نظر می‌کند و دو مسیر داده‌شده را مستقیماً در سیستم فایل مقایسه می‌کند.

  • مگر اینکه مسیرهایی را در یک درخت کاری تحت مدیریت گیت مقایسه کنیم و دست‌کم یکی از مسیرها خارج از درخت کاری باشد.

  • یا اینکه گیت درخت کاری را مدیریت نکند؛ در این حالت باید از گزینه --no-index استفاده کنیم.

  • گزینه --exit-code که نشان می‌دهد آیا تفاوتی بین مسیرها وجود دارد یا خیر، به‌صورت ضمنی در این نسخه از git diff اعمال می‌شود.

git diff [<options>] --cached [--merge-base] [<commit>] [--] [<path>]
  • تغییرات استیج‌شده برای کامیت پیش رو را در مقایسه با یک <commit> مشخص ارزیابی می‌کند.

  • در صورت نبود <commit>، به‌طور پیش‌فرض از HEAD استفاده می‌شود.

  • اگر <commit> ارائه نشود و HEAD وجود نداشته باشد (مثلاً در شاخه‌های متولدنشده یا unborn branches)، تمام تغییرات استیج‌شده نمایش داده می‌شوند.

  • گزینه --merge-base به‌جای استفاده از <commit>، از مبنای ادغام (merge base) بین <commit> و HEAD استفاده می‌کند.

  • --staged و --cached معادل یکدیگرند و جایگزین هم می‌شوند.

git diff [<options>] [--merge-base] <commit> [--] [<path>]
  • تغییرات درخت کاری ما را نسبت به <commit> مشخص‌شده ارزیابی می‌کند.

  • برای مقایسه سر یک شاخه با آخرین کامیت، از HEAD استفاده کنید.

  • برای مقایسه سر یک شاخه دیگر، از نام آن شاخه استفاده کنید.

  • گزینه --merge-base برای یافتن مبنای مقایسه، مبنای ادغام بین <commit> و HEAD را محاسبه می‌کند.

  • برای مثال، git diff $(git merge-base A HEAD) برابر با git diff --merge-base A است.

git diff [<options>] [--merge-base] <commit> <commit> [--] [<path>]
  • تغییرات دو آبجکت <commit> مشخص‌شده را مقایسه می‌کند.

  • اگر --merge-base مشخص شده باشد، برای تعیین سمت قبل (before) مقایسه، مبنای ادغام بین دو کامیت محاسبه می‌شود.

  • برای مثال، git diff $(git merge-base A B) B همان git diff --merge-base A B است.

git diff [<options>] <commit> <commit> <commit> [--] [<path>]
  • برای مشاهده تغییرات ناشی از یک کامیت ادغامی (merge commit) به کار می‌رود.

  • خودِ ادغام باید اولین <commit> ذکرشده باشد و کامیت‌هایی که پس از آن می‌آیند، والدهای آن هستند.

  • پسوندهایی مانند ^@ و ^! تعریف نسخه‌های مورد نظر را آسان می‌کنند.

  • برای مثال، diff ترکیبی برای یک کامیت ادغامی A با دستورهای git diff A A^@، git diff A^! و git show A تولید می‌شود.

git diff [<commit>] <commit>..<commit> [--] [<path>]
  • مانند حالت بدون ..، به ما اجازه می‌دهد تفاوت‌های بین دو آبجکت <commit> دلخواه را ببینیم.

  • وقتی <commit> در یکی از طرفین وجود نداشته باشد، به‌طور پیش‌فرض از HEAD برای مقایسه استفاده می‌شود.

  • این دستور برای مقایسه یک کامیت با وضعیت کاری فعلی یا تحلیل تفاوت‌های بین کامیت‌های خاص مفید است.

git diff [<options>] <blob> <blob>
  • دستور گیت git diff [<options>] <blob> <blob> محتوای خام دو آبجکت blob را مقایسه کرده و تفاوت‌های آن‌ها را نمایش می‌دهد.

  • با این دستور می‌توانیم محتوای فایل‌ها یا آبجکت‌های موجود در مخزن را مستقیماً با هم مقایسه کنیم.

Options

دستور git diff گزینه‌های زیر را دارد:

Comparing Changes

در ادامه فهرستی از دستورهایی آمده که می‌توان برای مقایسه تغییرات استفاده کرد:

  • git diff − تغییرات استیج‌نشده را نمایش می‌دهد.

  • git diff --cached یا git diff --staged − تغییرات استیج‌شده را نمایش می‌دهد.

  • git diff <commit1><commit2> − تغییرات بین دو کامیت مختلف را نمایش می‌دهد.

  • git diff <branch1><branch2> − تغییرات بین دو شاخه مختلف را نمایش می‌دهد.

Based on Outout Formats

در ادامه فهرستی از گزینه‌هایی آمده که بر اساس قالب خروجی استفاده می‌شوند:

  • --stat − خلاصه‌ای از تغییرات، یعنی تعداد خطوط اضافه‌شده و حذف‌شده را برای هر فایل نمایش می‌دهد.

  • --name-only − فقط نام فایل‌هایی را نمایش می‌دهد که تغییر کرده‌اند.

  • --name-status − هم نام و هم وضعیت فایل‌های تغییریافته را نمایش می‌دهد؛ چه اضافه‌شده، چه حذف‌شده یا تغییریافته باشند.

  • --color − خروجی رنگی نمایش می‌دهد و به خوانایی کمک می‌کند.

Based on Limiting Output

در ادامه گزینه‌هایی آمده که برای محدود کردن خروجی به کار می‌روند:

  • -U<n> − یک diff یکپارچه با <n> خط زمینه (context) نمایش می‌دهد؛ مثلاً -U5 پنج خط زمینه نمایش می‌دهد.

  • --word-diff − تغییرات را در سطح کلمه نمایش می‌دهد و آن‌ها را برجسته می‌کند.

Based on Ignoring Changes

در ادامه گزینه‌هایی آمده که برای نادیده گرفتن تغییرات استفاده می‌شوند:

  • --igonore-space-at-eol − تغییرات فضاهای خالی در انتهای خط را نادیده می‌گیرد.

  • --ignore-space-change − تغییرات مقدار فضاهای خالی را نادیده می‌گیرد.

  • -ignore-all-space − همه فضاهای خالی را نادیده می‌گیرد.

Working with Patches

در ادامه گزینه‌ای آمده که مربوط به کار با پچ‌ها (patches) است:

  • -p or --patch − تفاوت را در قالب پچ نمایش می‌دهد

  • این گزینه‌ها به گیت می‌گویند که به‌طور خودکار یک پچ تولید کند.

Combined Options

دو یا چند گزینه را می‌توان به‌صورت ترکیبی استفاده کرد؛ برای مثال، --stat و --cached.

-s

--no-patch

  • در گیت، گزینه -s یا --no-patch خروجی سازوکار diff را به‌طور کامل متوقف می‌کند.

  • وقتی بخواهیم خروجی پچ را از دستورهایی مانند git show که به‌طور پیش‌فرض پچ‌ها را نمایش می‌دهند پنهان کنیم، به کار می‌آید.

  • علاوه بر این، این گزینه می‌تواند اثر گزینه‌هایی را که پیش‌تر در خط فرمان یا داخل یک alias داده شده‌اند، مانند --patch یا --stat، خنثی کند.

--output=<file>

  • گزینه --output=<file> در گیت به ما اجازه می‌دهد خروجی یک دستور را به‌جای خروجی استاندارد (stdout) به یک فایل مشخص هدایت کنیم.

  • این کار برای ذخیره فوری خروجی‌ها یا نتایج دستور در یک فایل جهت پردازش یا مراجعه در آینده مفید است.

--output-indicator-new=<char>

--output-indicator-old=<char>

--output-indicator-context=<char>

  • گیت به ما امکان می‌دهد با استفاده از گزینه‌های --output-indicator-new=<char>، --output-indicator-old=<char> و --output-indicator-context=<char>، نویسه نشانگر خطوط جدید، قدیمی یا خطوط زمینه را در پچ‌های ساخته‌شده سفارشی کنیم.

  • این نویسه‌ها به‌طور پیش‌فرض + برای خطوط جدید، - برای خطوط موجود و ' ' (فاصله برای خطوط زمینه) هستند.

  • نحوه نمایش گرافیکی diffها در پچ‌ها را می‌توان با این پارامترها سفارشی‌سازی کرد.

--raw

  • وقتی گزینه --raw برای تولید خروجی diff استفاده شود، گیت نمایشی ماشین‌خوان از تغییرات فایل ایجاد می‌کند.

  • این قالب برای اسکریپت‌نویسی و پردازش خودکار مفید است.

--patch-with-raw

  • در گیت، -p --raw معادل گزینه --patch-with-raw است.

  • این گزینه یک پچ با خروجی در قالب خام (raw) تولید می‌کند.

--indent-heuristic

  • گیت گزینه‌ای به نام --indent-heuristic دارد که یک روش ابتکاری (heuristic) را فعال می‌کند تا مرز بخش‌های diff را برای بهبود خوانایی پچ تغییر دهد.

  • این روش ابتکاری که به‌طور پیش‌فرض فعال است، با افزایش وضوح بصری تغییرات درون diffها، تلاش می‌کند درک و بررسی آن‌ها را ساده‌تر کند.

--no-indent-heuristic

  • گزینه --no-indent-heuristic در گیت، روش ابتکاری تغییر مرز بخش‌های diff را که برای ساده‌تر شدن خواندن پچ‌ها به کار می‌رود، غیرفعال می‌کند.

--minimal

  • گزینه --minimal در گیت تضمین می‌کند که کوچک‌ترین diff ممکن با صرف زمان بیشتر برای بهینه‌سازی خروجی تولید شود.

--patience

  • گزینه --patience در گیت از الگوریتم patience diff برای تولید diff استفاده می‌کند.

تمام گزینه‌های ذکرشده در بالا در صورتی که در حال اشکال‌زدایی (debugging)، بررسی تغییرات یا آماده‌سازی برای یک کامیت باشید، مفید هستند.

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