پث‌وایز

آموزش گیت و گیتهاب از صفردرس ۵ از ۱۲

مرج کردن برنچ‌ها با git merge

کارهای برنچ feature رو با git merge بیار روی main. تفاوت Fast-forward و Merge Commit رو یاد بگیر، برنچ‌های قدیمی رو با خیال راحت پاک کن و هیچ‌وقت برعکس مرج نکن.

چیزی که از این درس می‌بری

  • اول git switch main رو بزن، بعد git merge feature: همیشه روی برنچی وایسا که کارها رو تحویل می‌گیره.
  • اگه main تکون نخورده باشه، Fast-forward اشاره‌گر برنچ رو میاره جلو؛ برنچ‌هایی که مسیرشون جدا شده، کامیت مرج می‌سازن.
  • بعد از مرج شدن، با git branch -d feature تمیزکاری کن؛ حرف کوچک -d جلوی پاک شدن کارهای مرج‌نشده رو می‌گیره.
فهرست این درس۷
  1. جایی وایسا که می‌خوای تغییرات بشینن
  2. ورک‌فلوی استاندارد مرج در ۳ مرحله
  3. مقایسه Fast-forward و Merge Commit
  4. قدم زدن رو به جلو در برابر ساختن پل
  5. پاک کردن برنچ‌های مرج‌شده با git branch -d
  6. ۴ نکته که باید قبل از مرج یادت باشه
  7. مرور درس

۰۱قانون مرج

جایی وایسا که می‌خوای تغییرات بشینن

بزرگ‌ترین دلیل گیج شدن توی مرج، جهتشه. دستور git merge همیشه تغییرات رو می‌کشه توی برنچ فعلیت. برای اینکه برنچی به اسم feature رو بیاری توی main، اول باید سوییچ کنی روی main و تازه بعدش بزنی git merge feature.

فرض کن توی پذیرایی (main) وایسادی و یه صندلی آماده (feature) رو از در ورودی میاری تو. توی کارگاه وای‌نمی‌سی تا پذیرایی رو بچینی!

۰۲قدم‌به‌قدم

ورک‌فلوی استاندارد مرج در ۳ مرحله

  1. ۱. همه کارهات رو روی برنچ فیچرت کامیت کن

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

  2. ۲. سوییچ کن روی برنچ مقصد (main)

    دستور git switch main رو بزن. پرامپتت رو چک کن یا git status رو اجرا کن تا مطمئن بشی HEAD واقعاً روی main قرار داره.

  3. ۳. دستور git merge رو با اسم فیچر اجرا کن

    دستور git merge feature رو بزن. گیت کامیت‌ها رو از feature برمی‌داره و به main اضافه می‌کنه.

خودت رو امتحان کنسؤال ۱ از ۴

سارا فرم لاگین رو روی یه برنچ به اسم login-page تموم کرده. حالا می‌خواد اون تغییرات رو مرج کنه توی main. باید چی‌کار کنه؟

  1. روی login-page بمونه و بزنه git merge main
  2. اول سوییچ کنه روی main، بعد بزنه git merge login-page
  3. اول بزنه git merge login-page، بعد سوییچ کنه روی main
  4. برنچ login-page رو با git branch -d پاک کنه تا مرج انجام بشه
جواب رو ببین

اول سوییچ کنه روی main، بعد بزنه git merge login-page

دقیقاً درسته. همیشه اول سوییچ می‌کنی روی برنچ گیرنده (main) و بعد برنچ فیچر رو توش مرج می‌کنی.

مقایسه Fast-forward و Merge Commit

مرج Fast-forward

وقتی پیش میاد که از زمان ساختن برنچت، main هیچ تغییری نکرده باشه. گیت نیازی به ترکیب کارهای در تضاد نداره؛ خیلی ساده پوینتر main رو سُر می‌ده جلو تا به فیچرت برسه. هیچ کامیت اضافه‌ای هم ساخته نمی‌شه.

کامیت مرج (3-way merge)

وقتی پیش میاد که موقع کار تو روی برنچت، روی main کامیت‌های جدیدی اومده باشه. مسیرها از هم جدا شدن. گیت یه کامیت اسنپ‌شات کاملاً جدید با ۲ کامیت والد می‌سازه تا هر دو تاریخچه رو به هم گره بزنه.

قدم زدن رو به جلو در برابر ساختن پل

مرج Fast-forward مثل راه رفتن پشت سر همه: تو ۵ قدم رفتی جلو و دوستت روی main هم فقط میاد جلو تا جایی که وایسادی. یه کامیت مرج مثل رفتن از دو تا مسیر جدا دور یه دریاچه‌ست؛ جایی که دوباره به هم می‌رسید باید یه پل جدید بسازید تا هر دو مسیر به هم وصل بشن. جایی که این تشبیه فرق داره: گیت اون پل رو خودکار در قالب یه دونه کامیت مرج می‌سازه، بدون اینکه نیاز باشه خودت آجری بذاری.

خودت رو امتحان کنسؤال ۲ از ۴

توی هر کدوم از این موقعیت‌ها، گیت از کدوم نوع مرج استفاده می‌کنه؟

Fast-forwardMerge Commit

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

Fast-forward: امید ۳ تا کامیت به یه برنچ اضافه کرد؛ این وسط هیچ‌کس روی main کامیتی نزد., گیت فقط لازمه اشاره‌گر برنچ main رو ببره جلو تا به آخرین کامیت برسه., یه برنامه‌نویس تنها که به نوبت، هر بار روی یه فیچر کار می‌کنه.

Merge Commit: نگار داشت روی یه فیچر کار می‌کرد در حالی که هم‌تیمیش یه رفع باگ رو مستقیماً روی main کامیت کرد., گیت یه کامیت جدید می‌سازه که والدهای اون، نوک هر دو برنچ هستن., دو تا برنچ فیچر که هم‌زمان از main انشعاب گرفتن و با چند ساعت فاصله مرج می‌شن.

مثال

git switch main
Switched to branch 'main'

git merge contact-form
Updating a3c4e5f..b7d8f9a
Fast-forward
 contact.html | 24 +++++++++++++++++++++++-
 style.css    |  6 ++++++
 2 files changed, 29 insertions(+), 1 deletion(-)

خروجی

Fast-forward merge complete: main is now at b7d8f9a

یه مرج Fast-forward تمیز توی ترمینال

۰۵تمیز نگهش دار

پاک کردن برنچ‌های مرج‌شده با git branch -d

وقتی یه برنچ توی main مرج شد، کارش تموم شده. کامیت‌هاش الان با خیال راحت بخشی از تاریخچه اصلی پروژه‌تن. نگه داشتن ده‌ها اسم برنچ قدیمی فقط خروجی git branch رو شلوغ می‌کنه. برنچ رو با git branch -d <name> پاک می‌کنی. حرف کوچک -d یه چک ایمنی داره: اگه کامیت‌هاش هنوز مرج نشده باشن، گیت از پاک کردن برنچ خودداری می‌کنه.

دستور git branch -d contact-form پیام Deleted branch contact-form رو چاپ می‌کنه. اگه تصادفی اسم برنچی رو با کارهای ناتموم تایپ کنی، گیت متوقف می‌شه و بهت هشدار می‌ده: error: The branch is not fully merged.

خودت رو امتحان کنسؤال ۳ از ۴

وقتی یه برنچ مرج‌شده رو با git branch -d پاک می‌کنی، همه کامیت‌هایی که روی اون برنچ زدی هم پاک می‌شن.

  1. درست
  2. نادرست
جواب رو ببین

نادرست

غلطه. توی گیت، برنچ فقط یه اشاره‌گر سبک و متحرک یا یه برچسب روی یه کامیت مشخصه. پاک کردن برنچ، برچسب رو حذف می‌کنه، ولی همه کامیت‌هات با خیال راحت توی main می‌مونن.

۴ نکته که باید قبل از مرج یادت باشه

  • ببین کجایی: همیشه قبل از مرج، با git status یا چک کردن پرامپت مطمئن شو HEAD به main اشاره می‌کنه.
  • مرج Fast-forward تاریخچه رو تمیز نگه می‌داره: اگه هیچ کامیتی به main اضافه نشده باشه، گیت برچسب رو بدون کامیت جدید میاره جلو.
  • کامیت مرج کارهای جداشده رو یکی می‌کنه: وقتی هر دو برنچ جلو رفتن، گیت یه کامیت با ۲ والد می‌سازه تا وصلشون کنه.
  • برچسب قدیمی رو پاک کن: وقتی کارت رفت توی main، با دستور git branch -d پاکش کن تا پروژه‌ت مرتب بمونه.

خودت رو امتحان کنسؤال ۴ از ۴

کاوه می‌خواست برنچ payments رو مرج کنه توی main. در حالی که هنوز روی payments بود، اشتباهی زد git merge main. الان وضعیت پروژه‌ش چطوریه؟

  1. برنچ main الان همه کدهای payments رو داره، دقیقاً همون‌طور که از اول می‌خواست
  2. گیت با یه ارور دستور رو رد کرد، چون main محافظت‌شده‌ست
  3. برنچ payments کامیت‌های جدید main رو گرفت، اما خود main بدون تغییر موند
  4. هر دو برنچ با هم مرج شدن و خودکار از ریپازیتوریش پاک شدن
جواب رو ببین

برنچ payments کامیت‌های جدید main رو گرفت، اما خود main بدون تغییر موند

درسته. گیت همیشه تغییرات رو می‌کشه توی برنچ فعلیت. چون کاوه روی payments بود، payments با main آپدیت شد، در حالی که main اصلاً تغییری نکرد.

۰۷جمع‌بندی

مرور درس

  • اول git switch main رو بزن، بعد git merge feature: همیشه روی برنچی وایسا که کارها رو تحویل می‌گیره.
  • اگه main تکون نخورده باشه، Fast-forward اشاره‌گر برنچ رو میاره جلو؛ برنچ‌هایی که مسیرشون جدا شده، کامیت مرج می‌سازن.
  • بعد از مرج شدن، با git branch -d feature تمیزکاری کن؛ حرف کوچک -d جلوی پاک شدن کارهای مرج‌نشده رو می‌گیره.
  • برعکس مرج نکن: اجرای git merge main وقتی روی برنچ فیچر هستی، فیچر رو آپدیت می‌کنه نه main رو.

به سبک خودت یادش بگیر.

توی اپ از یادآی بخواه این درس رو ساده‌تر توضیح بده، از زندگی خودت مثال بزنه یا عمیق‌تر بره. بعد یه مسیر کامل دور هدف خودت بساز.

Cafe Bazaar Myket توی اپ شخصی‌سازیش کن