في الدرسين السابقين، كان جمع الفروع يعني الدمج، وكان السجلّ المتباعد يكسب merge commit. هذا صادق وآمن، لكن في repository مزدحم يبدأ git log --graph بالظهور كخريطة قطارات. الـ rebase (إعادة التأسيس) هو الطريقة الأخرى لجمع العمل: بدل أن يصل خطّين، ينقل خطك بحيث لا يبقى إلا خط واحد.
انفصل فرعك projects-grid عن main عند b2. ومنذ ذلك الحين كسب main الـ commit ذا المعرّف c3، وفي فرعك d4 و e5. من الفرع، شغّل:
git switch projects-grid\ngit rebase mainSuccessfully rebased and updated refs/heads/projects-grid.وجد Git الـ commits الموجودة على فرعك وليست على main (d4 و e5)، ووضعها جانبًا، ونقل فرعك إلى طرف main، ثم أعاد تشغيل كل تغيير فوقه، commitًا تلو الآخر.
الـ commits المُعاد تشغيلها commits جديدة. التغييرات والرسائل نفسها، لكن الآباء مختلفون، فالمعرّفات مختلفة. هذه ليست تفصيلة؛ إنها القصة كلها لمعرفة متى يكون الـ rebase آمنًا. معرّف الـ commit يتضمّن أباه، لذا لا تستطيع نقل commit، بل تصنع نسخة منه في مكان آخر.
\nالآن صار main سلفًا لفرعك، فإدخال العمل يتمّ بـ fast-forward:
git switch main\ngit merge projects-grid # Fast-forwardالسجلّ خط مستقيم، كأنك بدأت العمل على الشبكة (grid) بعد تصحيح الخطأ الإملائي.
\nلأن الـ rebase يعيد تشغيل الـ commits واحدًا تلو الآخر، فإن التعارض يوقفه عند commit بعينه. الروتين هو نفسه الذي تعلّمته في الدمج، مع كلمات مختلفة في النهاية:
\n# Git stops: CONFLICT (content): Merge conflict in projects.html\n# edit projects.html, remove the markers, check it\ngit add projects.html\ngit rebase --continue # finish this commit, replay the nextgit rebase --abort يعيد الفرع تمامًا إلى حيث كان قبل أن تبدأ. و git rebase --skip يُسقط الـ commit المتعارض، ونادرًا ما يكون هذا ما تريده.
مفاجأة واحدة: أثناء الـ rebase يتبادل “ours” و “theirs” موقعيهما. أنت تعيد تشغيل الـ commits الخاصة بك فوق main، لذا فالـ HEAD (النصف العلوي من التعارض) هو طرف main، والـ commit الخاص بك هو النصف السفلي. اقرأ الأسماء الدالّة، لا حدسك.
قبل أن تشارك فرعًا، تستطيع إعادة كتابة الـ commits الخاصة به. يفتح git rebase -i قائمة مهام في محرّرك:
git rebase -i mainpick 4b1e2c0 Add projects grid\npick 9a3d7f1 fix typo\npick c2e8b44 Grid gap on mobileغيّر الكلمة التي أمام الـ commit واحفظ. reword يعدّل رسالته، و squash أو fixup يطويه في الـ commit الذي فوقه (مع الاحتفاظ برسالته أو التخلّص منها)، و drop يحذفه، وإعادة ترتيب الأسطر تعيد ترتيب الـ commits. تغيير pick 9a3d7f1 إلى fixup 9a3d7f1 يحوّل ثلاثة commits إلى اثنين نظيفين. هكذا يُبقي المحترفون commits من نوع “fix typo” خارج الـ pull request.
الـ rebase يستبدل الـ commits بنسخ منها. هذا غير ضارّ حين تكون الوحيد الذي يملكها. لكنه فوضى حين يكون شخص آخر قد بنى على الأصلية: سجلّه ما زال يحتوي d4 و e5، وسجلّك يحتوي d4' و e5'، والـ pull التالي ينتج commits مكرّرة وتعارضات محيّرة.
إذن: لا تنفّذ rebase على commits موجودة خارج الـ repository الخاص بك وقد يكون الناس بنوا عليها عملًا. وعمليًا:
\nmain أو على أي فرع يسحب منه آخرون.git push --force-with-lease--force-with-lease يكتب فوق الفرع البعيد فقط إن كان ما زال يشير إلى حيث رأيته آخر مرة. وإن رفع زميل شيئًا في الأثناء، يرفض بدل أن يمحو عمله.
| \n | Merge | \nRebase | \n
|---|---|---|
| السجلّ | \nسجلّ صادق، مع merge commits | \nخطّي، كأن العمل جرى بالتتابع | \n
| معرّفات الـ commits | \nلا تتغيّر | \nتُعاد كتابتها | \n
| آمن على الفروع المشتركة | \nنعم | \nلا | \n
| التعارضات | \nتُحلّ مرة واحدة | \nقد تتكرّر مع كل commit يُعاد تشغيله | \n
خيار افتراضي معقول: نفّذ rebase لفرع الـ feature الخاص بك على main لتبقى محدَّثًا ولترتّبه قبل المراجعة؛ وادمجه (غالبًا عبر pull request) لإيصاله. وكثير من الفرق تضبط أيضًا git pull ليعيد تأسيس الـ commits التي لم تُرفع بعد، وهذا ما ستضبطه في القسم التالي، حين يحصل موقعك الشخصي أخيرًا على remote.
git rebase main يعيد تشغيل commits فرعك فوق طرف main، فينشئ commits جديدة بمعرّفات جديدة.","بعد الـ rebase، يصبح دمج الفرع في main عملية fast-forward، فيبقى السجلّ خطًا مستقيمًا.","أثناء تعارض الـ rebase، أصلح الملف، ونفّذ git add له، ثم git rebase --continue؛ و git rebase --abort يلغي الـ rebase بكامله.","القاعدة الذهبية ألّا تنفّذ rebase أبدًا على commits ربما بنى عليها آخرون؛ نفّذه فقط على عملك الخاص غير المشارَك.","إن اضطررت إلى تحديث فرع رفعته بالفعل، فاستخدم git push --force-with-lease، ولا تستخدم --force المجرّد أبدًا."],"further":[{"title":"Rebasing (Pro Git)","url":"https://git-scm.com/book/en/v2/Git-Branching-Rebasing"},{"title":"git rebase reference","url":"https://git-scm.com/docs/git-rebase"},{"title":"About Git rebase (GitHub Docs)","url":"https://docs.github.com/en/get-started/using-git/about-git-rebase"}],"quiz":[{"q":"في فرعك projects-grid الـ commitان d4 و e5. تشغّل عليه git rebase main. ماذا يحدث لـ d4 و e5؟
main.","why":"لا يمكن نقل الـ commits، لأن معرّف الـ commit يتضمّن أباه. أب جديد يعني commit جديدًا."},{"text":"يُدمجان في commit واحد على main.","why":"لا يضغط الـ rebase الـ commits افتراضيًا ولا يلمس main. إنه يعيد كتابة الفرع الذي أنت عليه."},{"text":"ينشئ Git commits جديدة بالتغييرات نفسها فوق main؛ ويشير الفرع إليها، وتصبح الأصلية بلا مرجع.","why":"صحيح. الـ commits المُعاد تشغيلها (وتُكتب غالبًا d4' و e5') لها معرّفات جديدة. وتبقى الأصلية في الـ reflog لفترة."},{"text":"يُحذفان وعليك إعادة تسجيل العمل.","why":"يعيد الـ rebase تشغيل تغييراتك تلقائيًا. لا شيء يحتاج إلى إعادة يدوية ما لم يقع تعارض."}],"answer":2},{"q":"في منتصف الـ rebase، يبلّغ Git عن تعارض في projects.html. حرّرت الملف حتى صار سليمًا. ماذا تشغّل بعد ذلك؟
git commit -m "Fix conflict"","why":"أثناء الـ rebase، ينشئ Git الـ commits بنفسه. إنشاء commit يدويًا يضيف commit زائدًا ويربك إعادة التشغيل."},{"text":"git add projects.html، ثم git rebase --continue","why":"صحيح. التجهيز يعلّم التعارض بأنه حُلّ؛ و --continue ينهي ذلك الـ commit ويعيد تشغيل البقية."},{"text":"git merge --continue","why":"أنت في rebase، لا في merge. لكل عملية أمر الإكمال الخاص بها."},{"text":"git rebase main مجددًا من البداية","why":"هناك rebase قيد التنفيذ أصلًا، فيرفض Git بدء آخر. أكمل الحالي أو ألغِه."}],"answer":1},{"q":"أيّ الحالات التالية تخرق القاعدة الذهبية للـ rebase؟
","options":[{"text":"تنفيذ rebase لفرعك المحليfooter الذي لم يُرفع قط على main.","why":"لا أحد غيرك يملك هذه الـ commits، فإعادة كتابتها لا تؤثّر إلا فيك. هذا هو الاستخدام المثالي للـ rebase."},{"text":"استخدام git rebase -i HEAD~3 لضغط إصلاحات الأخطاء الإملائية قبل فتح pull request.","why":"ترتيب الـ commits الخاصة بك التي لم تشاركها هو بالضبط الغرض من الـ rebase التفاعلي."},{"text":"تشغيل git pull --rebase لوضع الـ commits التي لم ترفعها بعد فوق الـ commits الجديدة لزملائك.","why":"هذا يعيد كتابة الـ commits المحلية التي لم تُرفع فقط، لذا فهو آمن وشائع."},{"text":"تنفيذ rebase لفرع main المشترك ورفعه بالقوة (force-push) بينما لدى زملائك عمل مبني عليه.","why":"صحيح. commits زملائك تقع فوق المعرّفات القديمة التي استبدلتها للتو، فينتج عن الـ pull التالي لديهم commits مكرّرة وتعارضات محيّرة."}],"answer":3},{"q":"نفّذت rebase لفرع الـ pull request الخاص بك، والآن يُرفض git push لأنه ليس fast-forward. ما الطريقة الآمنة لتحديثه؟
git push --force-with-lease","why":"صحيح. يكتب فوق الفرع البعيد فقط إن كان ما زال حيث رأيته آخر مرة، فلن تمحو بصمت commit رفعه شخص آخر منذ آخر fetch لك."},{"text":"git push --force","why":"هذا يكتب فوق الـ remote مهما كان، بما في ذلك commits رفعها مراجِع منذ آخر fetch لك."},{"text":"git pull ثم الرفع.","why":"الـ pull يدمج الـ commits القديمة مرة أخرى بجانب نسخها المُعاد تأسيسها، فتبقى commits مكرّرة في الفرع."}],"answer":0}],"exercise":{"kind":"fill","language":"bash","template":"git switch projects-grid\ngit {{0}} main # replay my commits on top of main\n# CONFLICT in projects.html: edit it, then\ngit add projects.html\ngit rebase {{1}} # replay the remaining commits\n\n# this branch was already pushed for review, so update it safely\ngit push {{2}}","blanks":[{"answers":["rebase"]},{"answers":["--continue"]},{"answers":["--force-with-lease"]}],"title":"نفّذ rebase لشبكة المشاريع","prompt":"فرعك projects-grid متأخّر عن main، وتريد سجلًّا خطيًا. املأ الفراغات لتنفّذ rebase له، وتتجاوز تعارضًا واحدًا، ثم تحدّث الفرع الذي رفعته أصلًا للمراجعة دون أن تخاطر بـ commits أي شخص آخر.
git add، يحتاج الـ rebase الجاري إلى كلمة أخرى ليواصل.","هناك خيار للرفع بالقوة يتحقّق من أن الـ remote لم يتغيّر منذ آخر fetch لك. إنه طويل، ويتضمّن كلمة lease."],"explanation":"git rebase main يعيد تشغيل commits الفرع فوق طرف main. وحين يتعارض commit مُعاد تشغيله، تصلح الملف، وتنفّذ git add له، وتشغّل git rebase --continue (أو --abort لتستسلم). الـ commits المُعاد تأسيسها لها معرّفات جديدة، لذا يُرفض الرفع العادي؛ و git push --force-with-lease يستبدل الفرع البعيد فقط إن لم يرفع إليه أحد منذ آخر مرة نظرت فيها. هذا مقبول على فرع المراجعة الخاص بك، وغير مقبول أبدًا على main.