git rebase لفرع: طريقة إعادة التأسيس بأمان خطوة بخطوة

لإعادة تأسيس فرع، اجلب التحديثات، وانتقل إلى الفرع، ثم أعد تطبيقه على الأساس الجديد: `git fetch origin` ثم `git switch topic` ثم `git rebase origin/main`. يضع Git إيداعات فرعك جانبًا، وينقل الفرع إلى نهاية origin/main، ثم يعيد تطبيق الإيداعات واحدًا تلو الآخر. فيبقى السجل خطًا مستقيمًا دون إيداع دمج. ويحصل كل إيداع مُعاد تطبيقه على معرّف جديد، لذا يحتاج الفرع الذي دفعته من قبل إلى git push --force-with-lease بعدها.

ماذا يفعل git rebase بالفرع؟

لنفترض أن للفرع topic إيداعين خاصين به، وأن main اكتسب ثلاثة إيداعات منذ بدأ الفرع. تحدّث إعادة التأسيس نقطة البداية هذه دون دمج main في فرعك:

# before
A---B---C---D---E   origin/main
     \
      F---G         topic

# after git rebase origin/main
A---B---C---D---E   origin/main
                 \
                  F'---G'   topic

يحمل F' وG' التغييرات والرسائل نفسها التي في F وG، لكنهما إيداعان جديدان بمعرّفين جديدين لأن الأصل تغيّر. أما الدمج من نقطة البداية نفسها فيُبقي الخطين ويضيف إيداعًا له أصلان. ويعرض درس الدمج مقابل إعادة التأسيس الحالتين على رسم واحد.

كيف أعيد تأسيس فرع بأمان خطوة بخطوة؟

افحص أولًا، واحفظ النهاية القديمة، ثم أعد التطبيق، ثم اختبر. والأوامر الثلاثة الأولى لا تعيد كتابة شيء:

# 1. update origin/main, your files stay as they are
git fetch origin

# 2. list the commits Git will replay
git log --oneline origin/main..topic

# 3. keep a name on the old tip
git branch topic-backup topic

# 4. replay
git switch topic
git rebase origin/main

توقف عند الخطوة 2 إن ظهر في القائمة إيداع لا تعرفه، فذلك يعني أن الفرع لم يبدأ من حيث ظننت. وحين تنتهي إعادة التأسيس، نفّذ git status للتأكد من اكتمالها، ثم شغّل اختباراتك. فقد تُفسد إعادة تأسيس بلا تعارضات سلوك الشيفرة.

حدّد الأساس في كل مرة. فالأمر git rebase وحده يستخدم الفرع المتتبَّع، وهو غالبًا origin/topic لا main. ولنقل فرع بدأ من فرع ميزة آخر، حدّد الأساس القديم أيضًا: git rebase --onto main old-base topic. ويطبّق درس إعادة تأسيس العمل غير المنشور ذلك على رسم حقيقي.

كيف أعالج التعارضات في أثناء إعادة التأسيس؟

يطبّق Git إيداعاتك واحدًا تلو الآخر، فقد يتوقف أكثر من مرة حتى في الأسطر نفسها. عالج الإيداع الذي توقف عنده Git فقط، فالإيداعات التالية لم تُطبَّق بعد:

# edit the file and remove the conflict markers, then
git add path/to/file
git rebase --continue

إن تكرر التعارض نفسه، فالأمر git config rerere.enabled true يسجّل حلّك ويعيد استخدامه. راجع كل نتيجة معاد استخدامها، فحلّ الأمس قد يكون خاطئًا في شيفرة اليوم. ويتناول درس المتابعة والتخطي والإيقاف كل حالة، ويشرح مقال حل تعارضات الدمج قراءة العلامات.

كيف أراجع إعادة التأسيس قبل الدفع؟

قارن السلسلة القديمة بالجديدة قبل أن يراها أي أحد:

# old and new commits, matched pair by pair
git range-diff origin/main topic-backup topic

# everything the branch adds to main, as one diff
git diff origin/main...topic

# the shape of the history
git log --graph --oneline --decorate origin/main topic

يبيّن git range-diff متى غيّر حل التعارض تصحيحًا، أو متى اختفى إيداع. فالشيفرة التي تُترجم بنجاح قد تُخفي اختبارًا محذوفًا أو شرطًا تغيّر، وهنا تكتشف ذلك.

كيف أتراجع عن إعادة التأسيس؟

في أثناء عملها، استخدم git rebase --abort. وبعد انتهائها، أعد الفرع إلى نهايته القديمة. راجع git status أولًا، لأن --hard يتجاهل التغييرات غير المودعة:

git reset --hard topic-backup

# no backup? find the old tip in the reflog
git reflog show topic
git reset --hard <old-tip-hash>

ويتناول دليل التراجع عن reset وrebase والإيداع سجل المراجع بتفصيل أكبر.

كيف أدفع فرعًا أُعيد تأسيسه؟

يُرفض الدفع العادي، لأن الفرع البعيد ما زال يحمل الإيداعات القديمة فيراه Git تحديثًا غير سريع للأمام. راجع ما ستستبدله، ثم ادفع مع lease:

git fetch origin
git log --oneline topic..origin/topic
git push --force-with-lease origin topic

ينبغي ألا يعرض git log سوى إيداعاتك القديمة. وأي شيء آخر هو عمل زميل، فتوقف وأدخله أولًا. يستبدل --force-with-lease الفرع البعيد فقط إن كان ما زال حيث رآه آخر جلب، أما --force العادي فبلا هذا الفحص. وعمليات الجلب في الخلفية تحدّث تلك القيمة، لذا يمكن للسكربتات تحديد الإيداع المتوقع: git push --force-with-lease=topic:<expected-hash> origin topic.

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

يضم دليل إعادة تأسيس فرع كل الخيارات، ويغطي الدفع القسري الآمن خطوة الدفع. ولدمج الإيداعات أو إعادة صياغتها أو ترتيبها، اقرأ إعادة التأسيس التفاعلية في واجهة رسومية.