فصل 2 شاخه‌بندی در گیت درس 12 از 12

آموزش گیت - ادغام فشرده کامیت‌ها

Git squash تکنیکی در Git است که چندین کامیت را در یک کامیت یکپارچه ادغام می‌کند.

این روش با ترکیب چندین کامیت پیاپی در یک کامیت پایه واحد، تاریخچه کامیت‌ها را ساده‌سازی می‌کند و تاریخچه پروژه را خواناتر و قابل فهم‌تر می‌سازد.

  • Git squash معمولاً همراه با rebase تعاملی استفاده می‌شود، جایی که توسعه‌دهندگان می‌توانند انتخاب کنند کدام مشارکت‌ها ادغام شوند. این یک ابزار مستقل نیست.

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

  • ادغام فشرده کامیت‌ها پیش از ارسال pull request، با منظم و شفاف نگه داشتن تاریخچه، بررسی و همکاری بهتری را تسهیل می‌کند.

برای منظم نگه داشتن مخزن و ترکیب تغییرات متعدد در یک مورد، از دستورات زیر استفاده کنید:

git merge --squash bugfix-issue-123

این روش یک کامیت واحد در شاخه فعلی شما ایجاد می‌کند که شامل تمام کامیت‌های مربوط به bugfix-issue-123 است.

Squash Commits در Git

با ترکیب چندین مشارکت در یک کامیت واحد، می‌توان به کمک git squash commits تاریخچه Git را پاک‌سازی و منظم کرد.

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

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

چه زمانی کامیت‌ها را Squash کنیم

نکات زیر به ما کمک می‌کنند تصمیم بگیریم چه زمانی کامیت‌ها را squash کنیم:

  • یکپارچه‌سازی شاخه‌های فیچر: پیش از ادغام یک شاخه فیچر در شاخه اصلی، می‌توان چندین کامیت آن را در یک کامیت متراکم کرد.

    این روند به ارائه مجموعه‌ای یکپارچه و قابل فهم از تحولات تاریخی پروژه ما کمک می‌کند.

  • آماده‌سازی برای Pull Requestها: squash کردن کامیت‌ها تضمین می‌کند که پیش از ارسال pull request (PR)، تنها مهم‌ترین تغییرات در آن قرار بگیرند.

    در نتیجه، بازبین‌ها راحت‌تر هدف و دامنه تغییرات را درک خواهند کرد.

  • پاک‌سازی تاریخچه کامیت‌ها: یکپارچه‌سازی تعداد زیادی کامیت کوچک یا مرحله‌ای در کامیت‌های کمتر و بزرگ‌تر می‌تواند به خواناتر شدن تاریخچه کامیت‌ها و ساده‌تر شدن پیمایش در آن کمک کند.

چگونه کامیت‌ها را Squash کنیم؟

Git چندین روش برای squash کردن چند کامیت در یک کامیت ارائه می‌دهد:

  • squash کردن کامیت‌ها در حین یک Git merge.

  • squash کردن کامیت‌ها با استفاده از Git rebase تعاملی.

  • squash کردن کامیت‌ها از طریق یک pull request.

  • squash کردن کامیت‌ها با Git reset.

Squash کردن کامیت‌ها در حین یک Git Merge

یک روش ساده برای ترکیب چندین کامیت از یک شاخه فیچر در یک کامیت واحد روی شاخه فعلی ما، استفاده از git merge همراه با پرچم --squash است.

این روش به حفظ یک تاریخچه کامیت شفاف و قابل فهم کمک می‌کند.

مراحل Squash کردن کامیت‌ها با استفاده از git merge:

انتخاب شاخه مقصد: به شاخه‌ای بروید که می‌خواهید تغییرات را در آن ادغام کنید:

git checkout <target_branch>

ادغام با Squash: کامیت‌های شاخه مبدا را با استفاده از دستور زیر در یک کامیت واحد squash کنید:

git merge --squash <source_branch>

این کار بدون انجام واقعی کامیتِ ادغام یا تغییر HEAD، تغییرات را برای یک کامیت واحد آماده می‌کند.

حل تعارض‌ها: در صورتی که تعارضی رخ دهد، آن‌ها را به‌صورت دستی در دایرکتوری کاری برطرف کنید.

کامیت کردن تغییرات Squash‌شده: یک کامیت واحد با یک پیام ایجاد کنید:

git commit -m "<your_commit_message>"

پوش کردن تغییرات: تغییرات را به مخزن ریموت پوش کنید.

برای اینکه مطمئن شوید تغییرات دیگران را بازنویسی نمی‌کند، از --force-with-lease استفاده کنید:

git push --force-with-lease

Squash کردن کامیت‌ها با استفاده از Git Rebase تعاملی

مراحل Squash کردن کامیت‌ها با استفاده از Rebase تعاملی

انتخاب شاخه: به شاخه‌ای بروید که حاوی کامیت‌هایی است که می‌خواهید squash کنید:

git checkout <branch_name>

تعیین تعداد کامیت‌ها: تاریخچه کامیت‌ها را ببینید و تعداد کامیت‌های روی شاخه را بشمارید:

git log --graph --oneline --all

شروع Rebase تعاملی: rebase تعاملی باید برای تعداد مناسبی از کامیت‌ها آغاز شود.

مقدار <number_of_commits> را با تعداد به‌دست‌آمده از مرحله قبل جایگزین کنید. برای مثال، برای squash کردن دو کامیت آخر:

git rebase -i HEAD~2

انتخاب اکشن‌های Rebase: در ویرایشگر متنی که باز می‌شود، فهرستی از کامیت‌ها را مشاهده خواهیم کرد.

ممکن است برای مشخص کردن هر کامیت، یک اکشن (pick، squash و غیره) به‌کار رفته باشد.

برای squash کردن کامیت‌ها، برای کامیت‌هایی که می‌خواهیم با کامیتِ بالای خودشان ترکیب شوند، pick را به squash تغییر دهید.

ذخیره و خروج: ویرایش‌ها را ذخیره کنید و سپس ویرایشگر متن را ببندید. Git عملیات rebase را مطابق دستورالعمل‌های ما انجام خواهد داد.

ویرایش پیام کامیت: با استفاده از یک ویرایشگر متن دیگر، می‌توانیم یک پیام کامیت برای کامیت squash‌شده بنویسیم.

می‌توانیم پیام ازپیش‌نوشته‌شده را تغییر دهیم یا یک پیام کاملاً جدید بنویسیم. پس از اتمام، ذخیره و بسته کنید.

پوش کردن تغییرات: پس از پایان rebase، فایل‌های به‌روزرسانی‌شده را به مخزن ریموت پوش کنید.

برای جلوگیری از بازنویسی تغییرات دیگران از --force-with-lease استفاده کنید:

git push --force-with-lease

Squash کردن کامیت‌ها از طریق Pull Request در GitHub

هنگام ایجاد pull request در پلتفرم‌هایی مثل GitHub، یک روش ساده برای squash کردن کامیت‌ها وجود دارد.

به کمک این قابلیت، کاربران می‌توانند در طول فرآیند ادغام با ترکیب چندین کامیت در یک کامیت واحد، تاریخچه کامیت‌ها را تمیز نگه دارند.

مراحل Squash کردن کامیت‌ها با استفاده از یک Pull Request:

  • رفتن به GitHub: مرورگر وب را باز کنید و به GitHub بروید.

  • ورود به حساب: وارد حساب کاربری GitHub شوید و مخزن مورد نظر را پیدا کنید.

  • ایجاد Pull Request: در مخزن به زبانه Pull requests بروید. روی دکمه New pull request کلیک کنید.

  • انتخاب Squash and Merge: پس از آماده شدن pull request، روی منوی کشویی Create a merge commit کلیک کنید و گزینه Squash and merge را انتخاب کنید.

  • افزودن کامنت: برای کامیت squash‌شده کامنتی بنویسید و با کلیک روی دکمه مربوطه فرآیند ادغام را نهایی و کامل کنید.

Squash کردن کامیت‌ها با git reset

مراحل Squash کردن کامیت‌ها با استفاده از git reset

استفاده از Soft Reset: یک soft reset انجام دهید تا HEAD به وضعیت پیش از کامیت‌هایی که می‌خواهید squash کنید منتقل شود.

این کار ایندکس یا دایرکتوری کاری را تغییر نمی‌دهد و تغییرات را دست‌نخورده نگه می‌دارد.

برای squash کردن تعداد مشخصی کامیت، دستور زیر را اجرا کنید:

git reset --soft HEAD~<number_of_commits> && git commit

تعداد کامیت‌هایی را که می‌خواهید squash کنید به‌جای <number_of_commits> قرار دهید.

ایجاد یک کامیت جدید: دستور git reset --soft شاخه را به وضعیت کامیت مشخص‌شده بازمی‌گرداند و در عین حال تمام تغییرات را در ناحیه staging نگه می‌دارد.

وقتی git commit را اجرا می‌کنیم، ویرایشگر متن پیش‌فرض همراه با پیام‌های کامیتِ ترکیب‌شده از کامیت‌های squash‌شده باز می‌شود.

می‌توانیم پیام کامیت را برای کامیت واحد و یکپارچه ویرایش کنیم یا پیام جدیدی اضافه کنیم.

برای تکمیل فرآیند، ویرایشگر را ذخیره و ببندید.

مزایای Squash کردن کامیت‌ها

مزایای squash کردن کامیت‌ها عبارت‌اند از:

  • ساده‌تر شدن بررسی کد (Code Reviews): بررسی یک کامیت بزرگ در هر بار، زمان کمتری نسبت به مرتب‌سازی و بررسی چندین کامیت کوچک‌تر می‌برد. این کار دیدن همه تغییرات به‌صورت یک‌جا را برای بازبین‌ها آسان‌تر می‌کند.

  • کاهش شلوغی مخزن: وقتی چندین کامیت در یک مورد ترکیب شوند، تاریخچه کامیت‌ها ورودی‌های کمتری خواهد داشت که شلوغی را به حداقل می‌رساند و ظاهر آن را تمیزتر می‌کند.

  • ساده‌تر شدن بازگردانی تغییرات (Rollbacks): مدیریت تغییرات معمولاً زمانی که یک کامیت واحد بازگردانده شود ساده‌تر است تا زمانی که چندین کامیت کوچک‌تر بازگردانده شوند.

  • ساده‌تر شدن ادغام (Merging): کاهش تاریخچه کامیت‌ها به تعارض‌های ادغام کمتری منجر می‌شود. معکوس کردن کامیت‌ها پیش از ادغام شاخه‌ها، فرآیند یکپارچه‌سازی را روان‌تر می‌کند.

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