مقدمه‌ی بر Git Diff

در توسعه نرم‌افزار، به ویژه هنگام کار با سیستم‌های کنترل نسخه مانند Git، بسیار مهم است که تغییرات را قبل از اعمال آنها بررسی کنید. Git ابزار قدرتمندی به نام `git diff` فراهم می‌کند که به توسعه‌دهندگان اجازه می‌دهد تفاوت‌های بین مراحل مختلف پروژه خود را مشاهده کنند. این کار به شناسایی مسائل پتانسیل و اطمینان از اینکه تنها تغییرات مورد نظر اعمال می‌شوند کمک می‌کند. با بررسی منظم دیف‌ها، توسعه‌دهندگان می‌توانند باگ‌ها را به زودی شناسایی کرده و کیفیت کد را حفظ کرده و اطمینان حاصل کنند که مجموعه کد نگهداری می‌شود و قابل درک باشد.

  • Git diff مراحل مختلف پروژه شما را، مانند دایرکتوری کاری، منطقه استیجینگ و کامیت‌ها، مقایسه می‌کند.
  • فهم دیف‌ها برای حفظ کیفیت کد و شناسایی خطاها به زودی ضروری است.
  • بررسی منظم دیف‌ها می‌تواند از انتشار مشکلات در مجموعه کد جلوگیری کند و همکاری بین اعضای تیم را بهبود بخشد.
git diff

ارجاع: [1] [2]

استفاده اولیه از Git Diff

بیشترین استفاده از `git diff` برای مشاهده تغییرات در دایرکتوری کاری که هنوز استیج نشده‌اند است. این کمک می‌کند تا بتوانید متوجه شوید که چه تغییراتی ایجاد کرده‌اید و تصمیم بگیرید کدام‌ها را ارسال کنید. علاوه بر این، می‌توانید از `git diff --cached` برای مشاهده تغییرات بین منطقه استیج و آخرین کامیت استفاده کنید، که برای بررسی تغییراتی که قرار است ارسال شوند مفید است.

  • برای مشاهده تغییرات بین دایرکتوری کاری و منطقه استیج، `git diff` را اجرا کنید.
  • برای مشاهده تغییرات بین منطقه استیج و آخرین کامیت، `git diff --cached` را استفاده کنید.
  • این دستورات نظر واضحی از آنچه در کامیت بعدی شامل خواهد بود ارائه می‌دهند و اجازه می‌دهند تا تصمیمات آگاهانه‌تر بگیرید.
git diff
# To see staged changes
git diff --cached

ارجاع: [1] [2]

مقایسه فایل‌های خاص

گاهی اوقات ممکن است بخواهید به فایل‌های خاص توجه کنید به جای کل پروژه. git diff اجازه می‌دهد مسیرها را مشخص کنید تا فقط آن فایل‌ها را مقایسه کنید. این ویژگی به ویژه در زمان کار با یک کدگذاری بزرگ مفید است و زمانی که نیاز به بررسی تغییرات در ماژول‌ها یا اجزای خاص دارید، مفید است.

  • برای مشاهده تغییرات در یک فایل خاص از `git diff <فایل>` استفاده کنید.
  • شما همچنین می‌توانید با لیست کردن فایل‌ها، چندین فایل را مقایسه کنید که در آن می‌توانید تغییرات مرتبط را همزمان بررسی کنید.
git diff src/main.py
# Compare multiple files
git diff src/main.py src/utils.py

ارجاع: [1] [2]

استفاده از Git Diff برای فرآیند ترکیب شاخه‌ها

در طول فرآیند ترکیب، مهم است تغییرات معرفی‌شده توسط هر شاخه را بررسی کنید. Git diff می‌تواند به شناسایی تداخلات و درک تغییرات قابل ترکیب کمک کند. این موضوع برای حل تداخلات ترکیب و حفظ عملکرد انتظاری کد ترکیب شده بسیار حیاتی است.

  • برای مشاهده تغییرات بین دو کامیت، از `git diff <کامیت> <کامیت>` استفاده کنید.
  • در صورت وجود تداخلات ترکیب، `git diff` تغییرات تداخلی از هر شاخه را نشان می‌دهد که به شما کمک می‌کند تا تفاوت‌ها را درک کنید و آن‌ها را حل کنید.
git diff HEAD~1 HEAD
# During a merge conflict
git diff --merge-base A B

ارجاع: [1] [2]

گزینه‌های پیشرفته برای Git Diff

Git diff چندین گزینه را ارائه می‌دهد تا خروجی را سفارشی‌سازی و برای سناریوهای مختلف مفید‌تر کند. این گزینه‌ها به شما اجازه می‌دهند خروجی diff را بر اساس نیاز خود تنظیم کنید، از طریق یک نظر کلی یا تغییرات خط به خط جزئی.

  • برای ایجاد یک فایل پچ استفاده کنید `-p` یا `--patch` که برای به اشتراک‌گذاری تغییرات با دیگران مفید است.
  • برای مشخص کردن تعداد خطوط متن افتراقی استفاده کنید `-U<n>` که می‌تواند به شما کمک کند تا کد محيطی را بهتر درک کنید.
  • برای دریافت خلاصه تغییرات استفاده کنید `--stat` که یک نظر کلی از آنچه تغییر یافته است ارائه می‌دهد.
git diff -p
# With 5 lines of context
git diff -U5
# Summary of changes
git diff --stat

ارجاع: [1] [2]

مثال عملی: بررسی تغییرات قبل از اعمال تغییرات

بیایید یک مثال عملی از استفاده از `git diff` برای بررسی تغییرات قبل از اعمال تغییرات مرور کنیم. فرض کنید شما برخی تغییرات را به یک اسکریپت پایتون اعمال کرده‌اید و می‌خواهید قبل از آماده‌سازی و اعمال تغییرات، همه چیز صحیح نظر بگیرید.

  • ابتدا برخی تغییرات را به `app.py` اعمال کنید و سپس `git diff` را اجرا کنید تا تغییرات در دایرکتوری کاری خود را مشاهده کنید.
  • تغییرات را با استفاده از `git add app.py` آماده کنید و سپس `git diff --cached` را اجرا کنید تا تغییرات آماده‌شده را بررسی کنید.
  • اگر همه چیز به نظر می‌رسد صحیح است، تغییرات را با استفاده از `git commit -m 'Update app.py'` اعمال کنید.
# Make changes to app.py
# Run git diff to see changes
$ git diff
# Stage the changes
$ git add app.py
# Review staged changes
$ git diff --cached
# Commit the changes
$ git commit -m 'Update app.py'

ارجاع: [1] [2]

فهرست بررسی

قبل از انجام کامیت، مطمئن شوید که تمام تغییرات را با استفاده از `git diff` بررسی کرده‌اید. این فهرست به شما کمک می‌کند تا بتوانید اطمینان حاصل کنید که کامیت خود آماده است و هیچ تغییر مهمی را نگذارید یا خطاهای جدیدی وارد نکرده‌اید.

  • برای بررسی تغییرات در دایرکتوری کاری با استفاده از `git diff` اجرا کنید.
  • برای بررسی تغییرات موقت با استفاده از `git diff --cached` استفاده کنید.
  • در صورت نیاز، تغییرات فایل‌های خاص را با استفاده از `git diff <فایل>` بررسی کنید.
  • در هنگام مерж، تغییرات مерж را با استفاده از `git diff <کامیت> <کامیت>` بررسی کنید.
  • از گزینه‌های پیشرفته مانند `-p`، `-U<n>` و `--stat` برای بررسی‌های جزئی استفاده کنید.
  • مطمئن شوید که تمام تغییرات به طور مقصود انجام شده‌اند و کد صحیح کامپایل و اجرا می‌شود.

ارجاع: [1] [2]

منابع و روش تهیه

منابع زیر توسط تحریریه انتخاب شده‌اند. پیش از اجرای مثال‌ها، مستندات جاری و شرایط پروژه را بررسی کنید.

  1. Git - git-diff Documentationافزوده‌شده: 2026-11-21
  2. Git - git-status Documentationافزوده‌شده: 2026-11-21

ایده را به کارِ قابل بررسی تبدیل کن.

مدل‌ها، ویرایشگر، ترمینال و مرورگر را در دوورا کنار هم داشته باش.

دریافت دوورا