ادغام — fast-forward، merge commit و تعارض

Merge یعنی دو خط تاریخچه را یکی کنی. اگر هر دو خط همان خطوط فایل را جور دیگری عوض کرده باشند، Git نمی‌داند کدام درست است — به آن تعارض می‌گویند و باید خودت انتخاب کنی.

🎯 اهداف یادگیری

• fast-forward را از merge commit تشخیص دهی
• تعارض را در VS Code با دکمه‌های Accept حل کنی
• --no-ff و --squash را بدانی کی استفاده کنی
• abort کنی وقتی اوضاع خراب شد

🧬 سه شکل ادغام

git switch main
git merge feat/auth

شکل ۵ — merge تاریخچه را حفظ می‌کند؛ rebase آن را خطی می‌کند (جزئیات در فصل ۲۳).

💥 تعارض — آناتومی

تعارض وقتی است که Git نمی‌تواند دو تغییر روی یک hunk را ترکیب کند.

<<<<<<< HEAD
return token;
=======
return rotate(token);
>>>>>>> feat/auth

سه نسخه در ذهن داشته باش:

• Ours / Current = شاخه‌ای که روی آن هستی (HEAD)
• Theirs / Incoming = شاخه‌ای که merge می‌کنی
• Base = جد مشترک (برای merge سه‌طرفه)

شکل ۶ — CodeLens: Accept Current، Accept Incoming، Accept Both، Compare Changes.

مسیر حل در VS Code

1. Source Control بخش Merge Changes را نشان می‌دهد
2. فایل را باز کن — نوار CodeLens بالای تعارض
3. انتخاب کن یا دستی ویرایش کن
4. فایل را Stage کن (علامت تعارض تمام می‌شود)
5. Commit ادغام را کامل می‌کند

git merge --abort              # پشیمانی قبل از commit
git merge --continue           # بعد از حل
git diff --name-only --diff-filter=U

🧰 استراتژی‌های پیشرفتهٔ merge

git merge -X ours feat/x       # در تعارض، ما برنده
git merge -X theirs feat/x
git log --merge                # فقط کامیت‌های درگیر تعارض
git checkout --conflict=diff3 -- file

diff3 جد مشترک را هم نشان می‌دهد — برای تعارض سخت طلایی است. در VS Code: "merge-conflict.diff3": true (یا Merge Editor).

VS Code Merge Editor سه‌ستونه (Incoming / Current / Result) را از Command Palette با Merge Conflict: Open Merge Editor باز می‌کند.

✅ چک‌لیست فهم