طريقة دمج فرع في فرع آخر في Git

لدمج `feature` في `main`، انتقل إلى الفرع الذي يستقبل الإيداعات، ثم ادمج الآخر: `git switch main` ثم `git merge feature`. الفرع الذي تقف عليه هو الذي يتغير. إن لم يكن في main إيداعات جديدة، يقدّمه Git تقديمًا سريعًا. وإلا فينشئ إيداع دمج، ويتوقف إذا تعارض الطرفان.

كيف أدمج فرعًا خطوة بخطوة؟

# get the latest
git fetch origin

# go to the branch that receives the work
git switch main
git pull --ff-only

# bring the other branch in
git merge feature/search

# publish it
git push

ابدأ من شجرة نظيفة: أودِع أو خبّئ أولًا. وإن غيّرت رأيك في منتصف الطريق، يعيدك `git merge --abort`.

في أي اتجاه يسير الدمج؟

يعني git merge X دائمًا «أحضر X إلى الفرع الذي أقف عليه». فدمج feature في main يتم من main، أما تحديث feature بأحدث main فيتم من feature:

# keep a feature branch up to date
git switch feature/search
git fetch origin
git merge origin/main

ما هو الدمج بالتقديم السريع؟

إذا لم يكن في الفرع المستقبل إيداعات خاصة به منذ انفصال الفرع الآخر عنه، فلا شيء يحتاج إلى جمع. ينقل Git مؤشر الفرع إلى أحدث إيداع في الفرع الآخر دون إضافة إيداع دمج، فيبقى السجل خطًا مستقيمًا. ويطبع Git كلمة Fast-forward عند حدوث ذلك.

# before
main:    A---B
              \
feature:       C---D

# after a fast-forward merge
main:    A---B---C---D

وعندما يكون لدى الفرعين إيداعات جديدة، يتعذر التقديم السريع، فينشئ Git إيداع دمج له أبوان. ويعرض درس التقديم السريع ودرس دمج الفروع المتباعدة الحالتين عمليًا.

ماذا تفعل --ff-only و--no-ff و--squash؟

git merge --ff-only origin/main
git merge --no-ff feature/search

git merge --squash feature/search
git commit -m "feat(search): quick open"

ماذا يحدث عند تعارض الدمج؟

يتوقف Git ويعلّم الملفات المتعارضة. حرّرها، ونفّذ git add على كل منها، ثم git commit لإنهاء الدمج. ويشرح مقال حل تعارضات الدمج العلامات.

هل يمكنني اختيار أحد الطرفين تلقائيًا؟

# take their side wherever hunks conflict
git merge -X theirs feature/search

# take our side wherever hunks conflict
git merge -X ours feature/search

# during a merge, take one side of a whole file
git checkout --theirs path/to/file
git add path/to/file

هل أدمج أم أعيد التأسيس؟

يحفظ الدمج السجل كما حدث ولا يعيد كتابة الإيداعات، فهو آمن دائمًا على الفروع المشتركة. أما إعادة التأسيس فتعيد تطبيق إيداعاتك فوق فرع آخر لتحصل على خط مستقيم، لكنها تعيد كتابتها، فاقصرها على الفروع التي تستخدمها وحدك. ويستعرض درس الدمج وإعادة التأسيس المقارنة بينهما.

ماذا أفعل بعد الدمج؟

# check that the branch is fully merged
git branch --merged

# delete it locally and on the remote
git branch -d feature/search
git push origin --delete feature/search

يشرح مقال طريقة حذف فرع خطوات التنظيف. وللتراجع عن دمج مدفوع بالفعل، راجع طريقة التراجع عن إيداع دمج.

راجع دمج الفروع لكل الخيارات.