DevOps والتشغيل الأدلة التقنية

Merge أم Rebase أم Squash؟ دمج الفروع في Git خطوة بخطوة

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

Merge أم Rebase أم Squash؟ دمج الفروع في Git خطوة بخطوة

أنهيت أول ميزة لك في فريق حقيقي، ودفعت الفرع إلى السيرفر، وفتحت طلب الدمج Pull Request، ووافق عليه زميلك، ثم ظهر لك زر أخضر بجانبه سهم صغير، وعندما ضغطت السهم وجدت ثلاثة خيارات: Create a merge commit وRebase and merge وSquash and merge. وقد تختار الأول لأنه الافتراضي، ثم يسألك قائد الفريق في اليوم التالي لماذا امتلأ التاريخ بسطور من نوع «Merge branch main into feature»، وقد يقول لك زميل آخر «اعمل Rebase قبل الدمج» فتنفذ الأمر ويظهر لك تعارض Conflict في ملف لم تلمسه، ولا تعرف هل تكمل أم تلغي. وهذه المواقف يمر بها كل من يبدأ العمل مع فريق، والسبب أن أغلب الشروحات تعطيك الأوامر دون أن تريك ماذا يحدث للتاريخ History تحت كل أمر.

وقد شرحنا في إدارة النسخ مع Git للمبتدئين ما هو ال Commit والفرع Branch ومنطقة التجهيز، وفي أول مستودع Git لك أنشأنا مستودعاً ودفعناه إلى Gitea. وهذا المقال هو الخطوة التالية: نأخذ مستودعاً صغيراً لمتجر، فيه فرع ميزة جاهز للدمج، ونطبق عليه الطرق الثلاث واحدة بعد الأخرى على النسخة نفسها، حتى ترى بعينك الفرق في شكل التاريخ، وفي أرقام ال Commits، وفي طريقة حل التعارض. وكل أمر في المقال نفذناه فعلاً، والمخرج المعروض هو ما طبعه Git كما هو. وسوف نناقش في هذا المقال ما يلي:

  • تجهيز المختبر: Container صغير فيه Git ومستودع متجر بفرع ميزة.
  • ما هو الفرع في الحقيقة، ولماذا يغير هذا الفهم طريقة نظرتك لكل الأوامر.
  • الدمج Merge بشكليه: الدمج السريع Fast-forward والدمج الثلاثي Three-way، والخياران --no-ff و--ff-only.
  • إعادة التأسيس Rebase: ماذا تفعل خطوة بخطوة، ولماذا تتغير أرقام ال Commits.
  • القاعدة الذهبية Golden Rule، مع تجربة حقيقية لما يحدث إذا تجاوزتها.
  • الأمر git pull --rebase، وإعادة التأسيس التفاعلية Interactive Rebase لترتيب عملك قبل المراجعة.
  • الدمج مع الضغط Squash Merge، ثم مقارنة الطرق الثلاث ومتى تختار كل واحدة.
  • التعارضات Conflicts في الدمج وفي إعادة التأسيس، ولماذا تنعكس فيها كلمة HEAD، والأمر rerere.
  • الدفع بالقوة الآمن --force-with-lease، وخطأ حقيقي يقع فيه كثيرون معه، ثم جدول الموقف والأمر وتدريب عملي.

تجهيز المختبر Lab Setup

لكي تجرب كل أمر دون أن تخاف على مشروع حقيقي، نشغل Container صغيراً من Alpine Linux ونثبت فيه Git، وهذا كل ما نحتاجه، فلا يوجد أي سيرفر أو خدمة أخرى. والسبب أننا نختار Container بدلاً من جهازك مباشرة أن كل شيء يختفي عند حذفه، فإذا أخطأت في أمر فلن يتأثر أي ملف عندك:

docker run -it --rm --name gsp-lab alpine:3.24 sh
apk add --no-cache git
git config --global user.name "ArabRoot Team"
git config --global user.email "[email protected]"
git config --global init.defaultBranch main

الأمر الأول يفتح لك سطر أوامر داخل ال Container، والخيار --rm يحذفه تلقائياً عندما تخرج منه. والأسطر الثلاثة الأخيرة تخبر Git باسمك وبريدك اللذين يكتبهما في كل Commit، وتجعل اسم الفرع الأول main. وقد استخدمنا في التجربة Git 2.54.0، وهو الإصدار الذي يأتي مع Alpine 3.24.

ثم ننشئ المستودع. والمتجر عندنا ملف واحد اسمه cart.py فيه دالة تحسب سعر المنتج، وملف README. وعلى main يوجد Commitان، ثم فتحنا فرعاً اسمه feature/discount وأضفنا فيه دالة الخصم في Commit، ووثقناها في README في Commit ثان. والأوامر التي أنشأت هذا المستودع موجودة كاملة في ملف المختبر مع المقال، وهذا هو شكل التاريخ في البداية:

git log --oneline --graph --all

والمخرج سوف يكون كما يلي:

* 320d164 Document discount
* 2fb0d79 Add discount
* 57f43bf Add README
* be16453 Add price function

وهذا الأمر سوف يتكرر كثيراً في المقال، لذلك نفهمه مرة واحدة: الخيار --oneline يعرض كل Commit في سطر واحد برقمه المختصر ورسالته، و--graph يرسم الخطوط بين ال Commits على اليسار، و--all يعرض كل الفروع وليس الفرع الحالي فقط. والأحدث دائماً في الأعلى. ولاحظ أن الرسم هنا خط مستقيم، لأن الفرع خرج من آخر Commit في main، ولم يتغير main بعد ذلك.

وفي كل تجربة نأخذ نسخة جديدة من هذا المستودع، حتى تبدأ كل طريقة من النقطة نفسها، فإذا رأيت أن الرقم 320d164 يتكرر في أكثر من قسم فهو ال Commit نفسه. وأرقام ال Commits عندك سوف تختلف عن أرقامنا، لأن الرقم يحسب من محتوى ال Commit ومن اسم الكاتب ووقت الكتابة، أما في التجربة فقد ثبتنا الوقت لكل أمر حتى نحصل على الأرقام نفسها إذا أعدنا التشغيل.

ما هو الفرع Branch في الحقيقة؟

قبل أي أمر دمج، توجد فكرة واحدة إذا فهمتها أصبح كل ما بعدها سهلاً: الفرع في Git ليس نسخة من الملفات، وليس مجلداً، وإنما هو ملف صغير فيه رقم Commit واحد فقط. والفرع main في مستودعنا هو ملف اسمه .git/refs/heads/main وفيه الرقم 57f43bf، والفرع feature/discount ملف آخر فيه الرقم 320d164. وكل Commit يعرف أباه Parent، أي ال Commit الذي جاء قبله، فإذا بدأت من أي فرع ومشيت إلى الخلف من أب إلى أب حصلت على تاريخ ذلك الفرع.

ولذلك عندما تنشئ Commit جديداً وأنت على فرع، فإن Git يكتب ال Commit ثم يحدث الرقم في ملف الفرع، أي أن الفرع مؤشر Pointer يتحرك إلى الأمام مع كل Commit. والمؤشر الخاص HEAD يشير إلى الفرع الذي تقف عليه الآن. ومن هنا نفهم أن كل أوامر هذا المقال تفعل واحداً من شيئين أو الاثنين معاً: إما أنها تنشئ Commits جديدة، وإما أنها تحرك مؤشر فرع من رقم إلى رقم. والدمج بأنواعه وإعادة التأسيس والضغط هي فقط طرق مختلفة لهذين الفعلين، فاسأل نفسك عند كل أمر: هل أنشأ Commits جديدة؟ وأي مؤشر تحرك؟ وهل تغير رقم أي Commit موجود؟ والسؤال الأخير هو الذي يحدد هل الأمر آمن على فرع يشاركك فيه غيرك.

الدمج Merge: جمع عمل فرعين

المشكلة التي يحلها الدمج بسيطة: أنهيت دالة الخصم في الفرع feature/discount، وتريد أن تصل إلى main حتى تدخل في الإصدار القادم. والأمر git merge ينفذ دائماً وأنت على الفرع الذي تريد أن تستقبل التغييرات، أي أنك تقف على main وتقول له ادمج فيه الفرع الآخر. وهذا أول خطأ يقع فيه المبتدئ: ينفذ الأمر وهو على فرع الميزة، فيدخل main في فرعه بدلاً من العكس. وللدمج شكلان، وGit يختار بينهما تلقائياً بحسب ما حدث في main أثناء عملك على الفرع، والصورة التالية تجمع الشكلين قبل أن نجربهما:

رسمان للتاريخ: في الأول يتقدم المؤشر main من B إلى D في خط مستقيم دون Commit جديد، وفي الثاني تقدم الفرعان فينشأ Merge Commit أخضر اسمه M له أبوان هما E من main وD من الفرع
الدمج السريع يحرك المؤشر فقط، والدمج الثلاثي ينشئ Merge Commit يربط التاريخين

الدمج السريع Fast-forward: عندما لا يتحرك main

في مستودعنا لم يضف أحد أي Commit إلى main منذ أن خرج منه الفرع، فالفرع هو main نفسه مع Commitين إضافيين في آخره. وفي هذه الحالة لا يحتاج Git أن يجمع أي شيء، فكل ما في main موجود أصلاً في الفرع، وكل ما يفعله هو أن ينقل المؤشر main إلى الأمام حتى يصل إلى آخر Commit في الفرع:

git switch main
git merge feature/discount
git log --oneline --graph

والمخرج سوف يكون كما يلي:

Already on 'main'

Updating 57f43bf..320d164
Fast-forward
 README.md | 2 ++
 cart.py   | 5 +++++
 2 files changed, 7 insertions(+)

* 320d164 Document discount
* 2fb0d79 Add discount
* 57f43bf Add README
* be16453 Add price function

في المخرج أعلاه لاحظ التالي:

  • السطر Updating 57f43bf..320d164 هو كل ما حدث: المؤشر main كان على 57f43bf وأصبح على 320d164، وهو آخر Commit في الفرع.
  • الكلمة Fast-forward تعني أنه لم ينشأ أي Commit جديد، ولذلك فالرقم الذي يظهر في أعلى git log هو رقم ال Commit الذي كتبته في الفرع نفسه.
  • السطور التي بعدها ملخص التغييرات التي دخلت main: سطران في README وخمسة في cart.py.
  • التاريخ بعد الدمج خط مستقيم، ولا يوجد فيه أي أثر يبين أن هذين ال Commitين كانا في فرع منفصل، وهذه نقطة سوف نرجع إليها بعد قليل.

الدمج الثلاثي Three-way Merge: عندما يتقدم الفرعان

هذه المرة نبدأ من نسخة جديدة من المستودع، ولكن قبل الدمج أضاف زميلك إلى main ملف الترخيص LICENSE في Commit جديد. والآن الفرعان تباعدا: main فيه Commit ليس في فرعك، وفرعك فيه Commitان ليسا في main، ولم يعد تحريك المؤشر ممكناً، لأن main لو انتقل إلى آخر الفرع فسوف يفقد Commit زميلك. لنر الشكل قبل الدمج ثم ندمج:

git log --oneline --graph --all
git merge feature/discount
git log --oneline --graph

والمخرج سوف يكون كما يلي:

* 2b7da1f Add license
| * 320d164 Document discount
| * 2fb0d79 Add discount
|/
* 57f43bf Add README
* be16453 Add price function

Merge made by the 'ort' strategy.
 README.md | 2 ++
 cart.py   | 5 +++++
 2 files changed, 7 insertions(+)

*   ed8083c Merge branch 'feature/discount'
|\
| * 320d164 Document discount
| * 2fb0d79 Add discount
* | 2b7da1f Add license
|/
* 57f43bf Add README
* be16453 Add price function

في المخرج أعلاه لاحظ التالي:

  • الرسم الأول يبين التباعد بوضوح: الخط الأيسر هو main وعليه 2b7da1f، والخط الذي بجانبه هو الفرع، والاثنان يخرجان من 57f43bf، وهذه النقطة تسمى الأصل المشترك Common Ancestor أو Merge Base.
  • اسم الدمج «ثلاثي» لأن Git يقارن ثلاث نسخ: الأصل المشترك 57f43bf، وآخر main، وآخر الفرع، فيعرف ما غيره كل طرف منذ الأصل، ثم يجمع التغييرين. ولأن زميلك غير LICENSE وأنت غيرت ملفين آخرين، فلم يتداخل شيء ونجح الدمج تلقائياً.
  • العبارة the 'ort' strategy اسم الخوارزمية التي جمعت التغييرات، وهي الخوارزمية الافتراضية عند دمج فرع واحد، ولا تحتاج أن تفعل معها أي شيء.
  • نتج Commit جديد رقمه ed8083c ورسالته «Merge branch 'feature/discount'»، وهذا هو التزام الدمج Merge Commit، والخطان اللذان يلتقيان عنده في الرسم يعنيان أن له أبوين.

وإذا أردت أن ترى بنفسك أن هذا ال Commit له أبوان، فاطلب من Git أن يطبعه كما هو مخزن في المستودع بالأمر git cat-file:

git cat-file -p HEAD
git log --merges --oneline

والمخرج سوف يكون كما يلي:

tree c7834c959afd305bbfb9ec836d098335dd1c38fe
parent 2b7da1f98623c459863030b4bf83d04ec2e0878d
parent 320d164be096bab4767cd3c1d31800f46743c181
author ArabRoot Team <[email protected]> 1793686260 +0300
committer ArabRoot Team <[email protected]> 1793686260 +0300

Merge branch 'feature/discount'

ed8083c Merge branch 'feature/discount'

هذا هو ال Commit من الداخل، وهو نص قصير: السطر tree يشير إلى لقطة الملفات بعد الدمج، ثم سطرا parent، الأول 2b7da1f وهو آخر main لأنك كنت تقف عليه، والثاني 320d164 وهو آخر الفرع، ثم الكاتب والوقت بالثواني منذ 1970، ثم الرسالة. وال Commit العادي فيه سطر parent واحد، وهذا الفرق الوحيد الذي يجعل منه Merge Commit. والأمر git log --merges يعرض فقط ال Commits التي لها أكثر من أب، وهو مفيد عندما تريد أن ترى متى دخلت كل ميزة إلى main.

وقد تسأل: لماذا لم يفتح Git المحرر لأكتب رسالة الدمج؟ والإجابة أنه في جهازك سوف يفتح المحرر برسالة جاهزة «Merge branch 'feature/discount'» فتحفظها وتغلق، أما في المختبر فقد جعلنا المحرر هو الأمر true عبر المتغير GIT_EDITOR، فيقبل الرسالة الجاهزة دون أن يتوقف.

الخيار --no-ff أو --ff-only: أنت من يقرر شكل الدمج

رأينا أن الدمج السريع لا يترك أي أثر للفرع، فبعد شهر لن تعرف من التاريخ أن Add discount وDocument discount كانا ميزة واحدة دخلت معاً، ولن تستطيع أن تتراجع عن الميزة كلها بأمر واحد. ولذلك يجبر الخيار --no-ff الأمر على إنشاء Merge Commit حتى لو كان الدمج السريع ممكناً، وهذا ما يفعله زر Create a merge commit في GitHub وفي Gitea. ونفذناه على نسخة جديدة لم يتحرك فيها main:

git merge --no-ff feature/discount
git log --oneline --graph

والمخرج سوف يكون كما يلي:

Merge made by the 'ort' strategy.
 README.md | 2 ++
 cart.py   | 5 +++++
 2 files changed, 7 insertions(+)

*   8ce06c6 Merge branch 'feature/discount'
|\
| * 320d164 Document discount
| * 2fb0d79 Add discount
|/
* 57f43bf Add README
* be16453 Add price function

المستودع هنا هو نفسه الذي دمجناه بالطريقة السريعة في القسم السابق، ولكن التاريخ الآن يبين الفرع كفقاعة واضحة تخرج من 57f43bf وتعود في 8ce06c6. أما الخيار المعاكس --ff-only فيقول لGit: ادمج فقط إذا كان الدمج سريعاً، وإلا فارفض ولا تنشئ Merge Commit من عندك. وهذا ما حدث عندما جربناه على النسخة التي تباعد فيها الفرعان:

git merge --ff-only feature/discount

والمخرج سوف يكون كما يلي:

hint: Diverging branches can't be fast-forwarded, you need to either:
hint:
hint: 	git merge --no-ff
hint:
hint: or:
hint:
hint: 	git rebase
hint:
hint: Disable this message with "git config set advice.diverging false"
fatal: Not possible to fast-forward, aborting.

الرسالة واضحة: الفرعان تباعدا، فلا يمكن الدمج السريع، وأمامك طريقان، إما Merge Commit بالخيار --no-ff، وإما git rebase الذي سوف نشرحه الآن. والسطور التي تبدأ بكلمة hint نصائح يطبعها Git للمبتدئين، والسطر الأخير يخبرك كيف تخفيها إذا لم تعد تحتاجها. ومتى يفيدك --ff-only؟ عندما تحدث نسختك المحلية من main من السيرفر، فأنت تريد أن تلحق بالسيرفر فقط، ولا تريد أن ينشأ عندك Merge Commit لم تقصده.

وقاعدة الأمان في الدمج بكل أشكاله أنه لا يغير أي Commit موجود، فالسريع يحرك مؤشراً إلى الأمام، والثلاثي يضيف Commit جديداً، ولا شيء غير ذلك. ولهذا فالدمج آمن دائماً على الفروع المشتركة مثل main، وزملاؤك يسحبون نتيجته كأي Commit آخر.

إعادة التأسيس Rebase: نقل عملك فوق آخر main

لنرجع إلى حالة التباعد: زميلك أضاف LICENSE إلى main، وأنت في فرعك Commitان. والدمج الثلاثي يحل المشكلة، ولكنه يضيف Merge Commit، وإذا كان الفريق خمسة أشخاص، وكل واحد يدمج main في فرعه كل صباح ليبقى محدثاً، فسوف يمتلئ التاريخ بسطور «Merge branch main into feature» لا تحمل أي معلومة، ويصبح الرسم شبكة من الخطوط يصعب أن تقرأها. وإعادة التأسيس Rebase طريقة أخرى: بدلاً من أن تربط التاريخين بMerge Commit، تأخذ Commits فرعك وتعيد تطبيقها واحداً بعد الآخر فوق آخر نقطة في main، فيصبح فرعك كأنك فتحته اليوم وليس قبل أسبوع. والكلمة نفسها تشرح الفكرة: تغيير الأساس Base الذي يقف عليه الفرع.

ولاحظ الفرق في الاتجاه: في الدمج تقف على main وتسحب الفرع إليه، أما في إعادة التأسيس فتقف على فرعك وتقول له انقل نفسك فوق main:

git switch feature/discount
git log --oneline --graph --all
git rebase main
git log --oneline --graph --all

والمخرج سوف يكون كما يلي:

Switched to branch 'feature/discount'

* be55f36 Add license
| * 320d164 Document discount
| * 2fb0d79 Add discount
|/
* 57f43bf Add README
* be16453 Add price function

Successfully rebased and updated refs/heads/feature/discount.

* 0b93e15 Document discount
* bf46922 Add discount
* be55f36 Add license
* 57f43bf Add README
* be16453 Add price function

في المخرج أعلاه لاحظ التالي:

  • قبل إعادة التأسيس كان الشكل هو التباعد نفسه الذي رأيناه في الدمج الثلاثي، ورقم Commit الترخيص هنا be55f36 لأنه نسخة أخرى من التجربة.
  • بعدها أصبح التاريخ خطاً واحداً، وCommitا الخصم يأتيان فوق Commit الترخيص مباشرة، ولا يوجد أي Merge Commit.
  • والأهم أن أرقامهما تغيرت: 2fb0d79 أصبح bf46922، و320d164 أصبح 0b93e15، مع أن الرسالة والتغيير في كل منهما كما هو.

ولماذا تغيرت الأرقام؟ تذكر ما رأيناه في git cat-file: كل Commit يحمل داخله رقم أبيه، ورقم ال Commit نفسه بصمة Hash تحسب من كل محتواه، بما فيه رقم الأب. فعندما يعيد Git تطبيق Add discount فوق be55f36 بدلاً من 57f43bf، يتغير سطر parent، فتتغير البصمة، أي أن Git لم ينقل ال Commits القديمة، وإنما أنشأ Commits جديدة فيها التغييرات نفسها، ثم نقل مؤشر الفرع إليها، وترك القديمة دون أي فرع يشير إليها. والصورة التالية تبين هذه الخطوات بالترتيب:

رسم قبل وبعد: قبل إعادة التأسيس يخرج الفرع feature/discount من B بال Commitين C وD، وبعدها يظهر Commitان جديدان فوق E برقمين جديدين bf46922 و0b93e15، والقديمان باللون الرمادي المتقطع لا يشير إليهما إلا reflog، وتحت الرسم أربع خطوات مرقمة
إعادة التأسيس تنسخ Commits الفرع فوق main بأرقام جديدة، والقديمة تبقى في reflog فقط

وأين ذهبت ال Commits القديمة؟ ما زالت في المستودع، وGit يحفظ سجلاً بكل حركة لكل مؤشر يسمى reflog، وهذا سجل الفرع في تجربتنا:

git reflog -n 6 feature/discount

والمخرج سوف يكون كما يلي:

0b93e15 feature/discount@{0}: rebase (finish): refs/heads/feature/discount onto be55f367dc5e57a8e4cc5c1448fa1b2e3b40b492
320d164 feature/discount@{1}: commit: Document discount
2fb0d79 feature/discount@{2}: commit: Add discount
57f43bf feature/discount@{3}: branch: Created from HEAD

اقرأ السجل من الأسفل إلى الأعلى: أنشئ الفرع على 57f43bf، ثم Commitان، ثم السطر الأخير يقول إن إعادة التأسيس نقلت الفرع إلى 0b93e15 فوق be55f36. والسطر feature/discount@{1} يعني «أين كان الفرع قبل حركة واحدة»، فإذا ندمت على إعادة التأسيس تستطيع أن ترجع الفرع إلى 320d164، وهذا ما سوف نشرحه بالتفصيل في التراجع عن الأخطاء في Git.

وبعد إعادة التأسيس يصبح دمج الفرع في main دمجاً سريعاً، لأن الفرع أصبح main مع Commits إضافية في آخره:

git switch main
git merge feature/discount

والمخرج سوف يكون كما يلي:

Switched to branch 'main'

Updating be55f36..0b93e15
Fast-forward
 README.md | 2 ++
 cart.py   | 5 +++++
 2 files changed, 7 insertions(+)

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

القاعدة الذهبية Golden Rule: لا تعد تأسيس Commits سحبها غيرك

بما أن إعادة التأسيس تنشئ Commits جديدة وتترك القديمة، فماذا يحدث إذا كان زميلك قد سحب الفرع القديم وبنى عليه عمله؟ يضع كتاب Pro Git القاعدة بوضوح: لا تقم بإعادة تأسيس Commits موجودة خارج مستودعك وقد يكون غيرك بنى عليها. ولكن القاعدة تبقى نظرية حتى ترى ما يحدث فعلاً، لذلك جربناها: أنشأنا مستودعاً على السيرفر Bare Repository داخل ال Container، ونسختين منه لشخصين، علي وسارة. علي فتح فرعاً مشتركاً اسمه feature/shared فيه Commitان للخصم ودفعه، وسارة سحبته وأضافت فوقه Commit «Add coupon» لم تدفعه بعد. ثم أضاف علي Commit إلى main، وقرر أن يعيد تأسيس الفرع المشترك عليه:

git rebase main
git push origin feature/shared
git push --force origin feature/shared

والمخرج سوف يكون كما يلي:

Successfully rebased and updated refs/heads/feature/shared.

To /work/remote.git
 ! [rejected]        feature/shared -> feature/shared (non-fast-forward)
error: failed to push some refs to '/work/remote.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. If you want to integrate the remote changes,
hint: use 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

To /work/remote.git
 + cf1e6e3...e4b7963 feature/shared -> feature/shared (forced update)

السيرفر رفض الدفع العادي بالسبب non-fast-forward، أي أن ما يرسله علي ليس امتداداً لما على السيرفر، فال Commits التي على السيرفر لم تعد في فرع علي. وهذا الرفض حماية، والرسالة تقترح git pull، ولكن علي تجاهلها ودفع بالقوة --force، فاستبدل السيرفر الفرع، والعلامة + وعبارة forced update تعنيان أن تاريخ الفرع على السيرفر أعيدت كتابته. والآن سارة تسحب الفرع كعادتها:

git pull --no-rebase origin feature/shared
cat cart.py

والمخرج سوف يكون كما يلي:

From /work/remote
 * branch            feature/shared -> FETCH_HEAD
 + cf1e6e3...e4b7963 feature/shared -> origin/feature/shared  (forced update)
Auto-merging cart.py
CONFLICT (content): Merge conflict in cart.py
Automatic merge failed; fix conflicts and then commit the result.

def price(item):
    return item["price"] * item["qty"]

def discount(total):
    return total * 0.9
<<<<<<< HEAD

def coupon(total, code):
    return total - 5 if code == "WELCOME" else total
=======
>>>>>>> e4b79630ab90e0528dc398de091ec391bde4e6da

سارة لم تغير دالة الخصم، وعلي لم يغيرها، ومع ذلك ظهر تعارض. والسبب أن Git يرى الآن تاريخين مختلفين لما يفترض أنه فرع واحد: النسخة القديمة من Commitي الخصم التي بنت عليها سارة، والنسخة الجديدة بأرقام أخرى، فيحاول أن يجمعهما كأنهما عمل شخصين مختلفين. وحلت سارة التعارض بأن أخذت نسختها كما هي بالأمر git checkout --ours cart.py، ثم أنهت الدمج، وهذا هو التاريخ عندها الآن:

git checkout --ours cart.py
git add cart.py
git commit --no-edit
git log --oneline --graph

والمخرج سوف يكون كما يلي:

Updated 1 path from the index

[feature/shared cdd0178] Merge branch 'feature/shared' of /work/remote into feature/shared

*   cdd0178 Merge branch 'feature/shared' of /work/remote into feature/shared
|\
| * e4b7963 Document discount
| * d003baa Add discount
| * 3b8271f Add contact
* | 46e8fc8 Add coupon
* | cf1e6e3 Document discount
* | 9151cab Add discount
|/
* 173834e Add license
* 1643d97 Add README
* c731aad Add price function

هذه هي الصورة التي تفسر القاعدة الذهبية: Add discount موجود مرتين برقمين 9151cab وd003baa، وDocument discount مرتين أيضاً، وإذا دفعت سارة هذا الفرع فسوف يرجع إلى السيرفر الشيء الذي حاول علي أن يزيله، وكل شخص آخر سحب الفرع سوف يمر بالمشكلة نفسها. والصورة التالية تلخص ما حدث في الخطوات الثلاث:

ثلاثة أجزاء: سارة تبني Commit اسمه S فوق D1 وD2 من الفرع المشترك، ثم علي ينفذ Rebase فوق Commit جديد K فتظهر نسختان D1 شرطة وD2 شرطة برقمين جديدين ويدفع بالقوة بعد رفض non-fast-forward، ثم عند سارة يجتمع التاريخان في Merge Commit اسمه M وتظهر D1 وD2 مرتين بحلقات حمراء، وتحتها القاعدة: Rebase مسموح على Commits لم يرها غيرك
إعادة تأسيس فرع مشترك تجعل ال Commits نفسها تظهر مرتين عند كل من سحبه
🛑
لا تقم بعمل Rebase لفرع مشترك مثل main أو develop، ولا لفرع دفعته وسحبه زميلك. والمسموح أن تعيد تأسيس Commits محلية لم تدفعها بعد، أو فرعك الشخصي الذي لا يعمل عليه أحد غيرك. وإذا رفض السيرفر الدفع بعد Rebase، فتوقف واسأل نفسك هل يعمل أحد على هذا الفرع قبل أن تضيف --force.

وكيف تخرج سارة من هذا الموقف إذا وقعت فيه؟ الطريقة الأنظف أن تلغي الدمج قبل أن تنهيه بالأمر git merge --abort، ثم تنقل Commit «Add coupon» وحده فوق النسخة الجديدة من الفرع، وهذا ما تفعله إعادة التأسيس نفسها إذا نفذت git pull --rebase بدلاً من الدمج، لأن Git يتعرف على ال Commits التي لها التغيير نفسه فيتخطاها. ولكن الحل الحقيقي ألا يحدث هذا أصلاً: الفرع المشترك يدمج فقط، والسيرفر يمنع الدفع بالقوة إلى الفروع المهمة بحماية الفروع Branch Protection، وقد شرحناها في مراجعة الكود Code Review.

السحب دون Merge Commits: git pull --rebase

بعد أن عرفنا متى تكون إعادة التأسيس خطيرة، نأتي إلى المكان الذي تكون فيه أفضل اختيار، وهو موقف يمر بك كل يوم: أنهيت Commit على main عندك، وتريد أن تدفعه، ولكن زميلك دفع قبلك. وفي التجربة كان لكل من علي وسارة نسخة من المستودع نفسه، فدفعت سارة Commit «Add README»، ثم أنشأ علي Commit «Add license» وحاول أن يدفع:

git push origin main
git pull origin main

والمخرج سوف يكون كما يلي:

To /work/remote.git
 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to '/work/remote.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

From /work/remote
 * branch            main       -> FETCH_HEAD
   c731aad..1643d97  main       -> origin/main
hint: You have divergent branches and need to specify how to reconcile them.
hint: You can do so by running one of the following commands sometime before
hint: your next pull:
hint:
hint:   git config pull.rebase false  # merge
hint:   git config pull.rebase true   # rebase
hint:   git config pull.ff only       # fast-forward only
hint:
hint: You can replace "git config" with "git config --global" to set a default
hint: preference for all repositories. You can also pass --rebase, --no-rebase,
hint: or --ff-only on the command line to override the configured default per
hint: invocation.
fatal: Need to specify how to reconcile divergent branches.

في المخرج أعلاه لاحظ التالي:

  • رفض الدفع بالسبب fetch first، أي اجلب أولاً، لأن على السيرفر Commit ليس عندك.
  • ثم اتبعنا النصيحة ونفذنا git pull، فجلب Git التزام سارة، والسطر c731aad..1643d97 يبين أن main على السيرفر تقدم إلى 1643d97، ولكنه توقف بعد ذلك ولم يغير شيئاً في فرعك.
  • والسبب أن git pull هو في الحقيقة أمران: git fetch يجلب الجديد، ثم دمج أو إعادة تأسيس. والإصدارات الحديثة من Git لا تختار عنك عندما يتباعد الفرعان، وتطبع لك الخيارات الثلاثة: الدمج pull.rebase false، وإعادة التأسيس pull.rebase true، والدمج السريع فقط pull.ff only.

وهذا الموقف بالذات هو أفضل استخدام لإعادة التأسيس، لأن Commit علي المحلي لم يره أحد بعد، فلا يوجد من بنى عليه:

git pull --rebase origin main
git log --oneline --graph
git push origin main

والمخرج سوف يكون كما يلي:

From /work/remote
 * branch            main       -> FETCH_HEAD
Successfully rebased and updated refs/heads/main.

* 173834e Add license
* 1643d97 Add README
* c731aad Add price function

To /work/remote.git
   1643d97..173834e  main -> main

جلب Git التزام سارة 1643d97، ثم أعاد تطبيق التزام علي فوقه فأصبح رقمه 173834e، والتاريخ خط مستقيم دون Merge Commit من نوع «Merge branch 'main' of …»، وقبل السيرفر الدفع لأنه أصبح امتداداً لما عنده، والسطر 1643d97..173834e يبين أن main على السيرفر تقدم تقدماً عادياً. ولو اخترنا الدمج هنا لظهر Merge Commit لا يحمل أي معلومة، سوى أن شخصين دفعا في اليوم نفسه. ولكي يصبح هذا هو السلوك الدائم دون أن تكتب الخيار كل مرة، نفذ مرة واحدة على جهازك:

git config --global pull.rebase true

ويذكر توثيق git pull هذا الإعداد وبدائله. وإذا ظهر تعارض أثناء السحب بهذه الطريقة فإن Git يتوقف عند ال Commit الذي فيه التعارض، فتحله كما سوف نشرح في قسم التعارضات، ثم تكمل بالأمر git rebase --continue، أو تلغي العملية كلها وترجع إلى ما كنت عليه بالأمر git rebase --abort.

إعادة التأسيس التفاعلية Interactive Rebase: رتب عملك قبل المراجعة

لنكن صادقين، فالتاريخ الحقيقي لأي فرع لا يبدو مرتباً: تكتب الميزة، ثم Commit اسمه «WIP debug» فيه ملف تجربة نسيت حذفه، ثم «fix typo» لأنك أخطأت في ال Commit السابق، ثم «docs». وهذه ال Commits مفيدة لك أثناء العمل لأنها نقاط حفظ ترجع إليها، ولكنها لا تفيد زميلك الذي يراجع طلب الدمج، ولا من يقرأ التاريخ بعد سنة. وهذا فرع حقيقي من هذا النوع أنشأناه في المختبر:

git log --oneline

والمخرج سوف يكون كما يلي:

23da3c7 Make the discount rate configurable
9e8f329 docs
25daa10 fix typo
d632cac WIP debug
90fa556 Add discount
570e9bc Add price function

والأمر git rebase -i main يعيد تأسيس الفرع على main كما رأينا، ولكنه قبل أن يبدأ يفتح لك المحرر بقائمة ال Commits التي سوف يعيد تطبيقها، وتسمى قائمة المهام Todo List، فتقرر لكل Commit ماذا تفعل به. ولكي نعرض القائمة هنا كما هي جعلنا المحرر هو الأمر cat عبر المتغير GIT_SEQUENCE_EDITOR، فطبعها Git ثم نفذها دون تغيير:

GIT_SEQUENCE_EDITOR=cat git rebase -i main

والمخرج سوف يكون كما يلي:

pick 90fa556 # Add discount
pick d632cac # WIP debug
pick 25daa10 # fix typo
pick 9e8f329 # docs
pick 23da3c7 # Make the discount rate configurable

# Rebase 570e9bc..23da3c7 onto 570e9bc (5 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup [-C | -c] <commit> = like "squash" but keep only the previous
#                    commit's log message, unless -C is used, in which case
#                    keep only this commit's message; -c is same as -C but
#                    opens the editor
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
#         create a merge commit using the original merge commit's
#         message (or the oneline, if no original merge commit was
#         specified); use -c <commit> to reword the commit message
# u, update-ref <ref> = track a placeholder for the <ref> to be updated
#                       to this position in the new commits. The <ref> is
#                       updated at the end of the rebase
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
Successfully rebased and updated refs/heads/feature/discount.

أول ما تلاحظه أن القائمة مرتبة من الأقدم إلى الأحدث، أي عكس git log، لأن Git سوف ينفذها من الأعلى إلى الأسفل. وكل سطر يبدأ بأمر ثم رقم ال Commit ثم رسالته، والسطور التي تبدأ بالعلامة # شرح يتجاهله Git. والأوامر التي سوف تستخدمها في أغلب الأحيان خمسة:

  • pick: أبق ال Commit كما هو.
  • reword: أبقه وغير رسالته فقط، فيفتح Git المحرر لتكتب الرسالة الجديدة.
  • squash: ادمجه في ال Commit الذي قبله في القائمة، واجمع الرسالتين في رسالة واحدة تحررها.
  • fixup: مثل squash، ولكنه يحذف رسالة هذا ال Commit ويبقي رسالة السابق، وهو المناسب لCommits من نوع «fix typo».
  • drop: احذف ال Commit وتغييراته من الفرع.

وتستطيع أيضاً أن تغير ترتيب السطور، فيعاد تطبيق ال Commits بالترتيب الجديد. والآن نكتب القائمة التي نريدها: نبقي «Add discount»، ونلحق به «fix typo» بالأمر fixup لأنه إصلاح له، ثم ننقل «Make the discount rate configurable» إلى مكانه بعدهما وندمجه بالأمر squash لأنه جزء من الميزة نفسها، ونحذف ملف التجربة بالأمر drop، ونغير رسالة «docs» إلى رسالة مفهومة بالأمر reword. وفي العمل اليومي تعدل هذه الأسطر في المحرر بيدك ثم تحفظ وتغلق، أما في المختبر فقد كتبناها بسكربت صغير جعلناه المحرر، ومعه سكربت آخر يكتب الرسالتين الجديدتين، وهذه هي القائمة التي نفذها Git بعد التعديل:

pick 90fa556 Add discount
fixup 25daa10 fix typo
squash 23da3c7 Make the discount rate configurable
drop d632cac WIP debug
reword 9e8f329 docs

ثم نفذنا إعادة التأسيس ونظرنا إلى النتيجة:

GIT_SEQUENCE_EDITOR="sh ../todo.sh" GIT_EDITOR="sh ../msg.sh" git rebase -i main
git log --oneline
git show --stat --format="%h %s" HEAD~1

والمخرج سوف يكون كما يلي:

[detached HEAD be0527c] Add a configurable discount
 Date: Tue Nov 3 09:28:00 2026 +0300
 1 file changed, 3 insertions(+)
[detached HEAD 32e1c84] Document the discount in README
 Date: Tue Nov 3 09:31:00 2026 +0300
 1 file changed, 2 insertions(+)
 create mode 100644 README.md
Successfully rebased and updated refs/heads/feature/discount.

32e1c84 Document the discount in README
be0527c Add a configurable discount
570e9bc Add price function

be0527c Add a configurable discount

 cart.py | 3 +++
 1 file changed, 3 insertions(+)

في المخرج أعلاه لاحظ التالي:

  • خمسة Commits أصبحت اثنين، كل واحد منهما يحمل فكرة كاملة برسالة واضحة، وهذا ما سوف يراه المراجع في طلب الدمج.
  • ال Commit be0527c يجمع ثلاثة: الدالة الأولى وإصلاحها والمعامل الجديد، والأمر git show --stat يبين أنه يغير cart.py فقط، أي أن ملف التجربة debug.py اختفى مع ال Commit الذي أضافه.
  • عبارة detached HEAD طبيعية أثناء إعادة التأسيس، لأن Git يبني ال Commits الجديدة أولاً دون فرع، ثم ينقل الفرع إليها في النهاية، ولهذا ترى في السطر الأخير updated refs/heads/feature/discount.
  • الأمر HEAD~1 يعني ال Commit الذي قبل HEAD بواحد، وHEAD~2 الذي قبله باثنين، وهكذا.

الإصلاح المؤجل: git commit --fixup مع autosquash

إذا كنت تعرف أثناء العمل أن ال Commit الذي تكتبه الآن إصلاح لCommit سابق، فلا تحتاج أن تتذكر ذلك لاحقاً في المحرر. في التجربة أضفنا «Add cart total» ثم «Document cart total»، ثم انتبهنا أن دالة المجموع يجب أن تتجاهل المنتجات التي كميتها صفر، فأصلحناها وكتبنا الإصلاح على أنه fixup لل Commit الذي قبل HEAD بواحد:

git add cart.py
git commit -q --fixup=HEAD~1
git log --oneline
GIT_SEQUENCE_EDITOR=cat git rebase -i --autosquash main

والمخرج سوف يكون كما يلي، بعد أن حذفنا من القائمة سطور الشرح نفسها التي رأيناها في المثال السابق:

cbafe1b fixup! Add cart total
1045969 Document cart total
d0bce04 Add cart total
32e1c84 Document the discount in README
be0527c Add a configurable discount
570e9bc Add price function

pick be0527c # Add a configurable discount
pick 32e1c84 # Document the discount in README
pick d0bce04 # Add cart total
fixup cbafe1b # fixup! Add cart total
pick 1045969 # Document cart total

الأمر --fixup كتب الرسالة بنفسه «fixup! Add cart total»، والخيار --autosquash قرأ هذه الرسالة فنقل السطر إلى مكانه تحت «Add cart total» وغير أمره إلى fixup دون أن نلمس القائمة، وبعد التنفيذ أصبح git log نظيفاً:

git log --oneline

والمخرج سوف يكون كما يلي:

4ea792f Document cart total
8a9b6de Add cart total
32e1c84 Document the discount in README
be0527c Add a configurable discount
570e9bc Add price function

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

الدمج مع الضغط Squash Merge

المشكلة التي يحلها Squash هي نفسها التي حلتها إعادة التأسيس التفاعلية، أي ال Commits الصغيرة الكثيرة في الفرع، ولكن بطريقة لا تحتاج أن يتقن كل شخص في الفريق rebase -i: عند الدمج يأخذ Git كل تغييرات الفرع ويضعها في Commit واحد جديد على main. وهذا ما يفعله زر Squash and merge في Gitea وGitHub، والأمر نفسه على جهازك هو git merge --squash. وفي التجربة أضفنا إلى الفرع Commit ثالثاً من نوع «WIP»، ثم دمجناه:

git switch main
git merge --squash feature/discount
git status --short
git commit -m "Add discount (#12)"
git log --oneline --graph --all

والمخرج سوف يكون كما يلي:

Updating 57f43bf..d70718f
Fast-forward
Squash commit -- not updating HEAD
 README.md | 2 ++
 cart.py   | 7 +++++++
 2 files changed, 9 insertions(+)

M  README.md
M  cart.py

[main c830269] Add discount (#12)
 2 files changed, 9 insertions(+)

* c830269 Add discount (#12)
| * d70718f WIP
| * 320d164 Document discount
| * 2fb0d79 Add discount
|/
* 57f43bf Add README
* be16453 Add price function

في المخرج أعلاه لاحظ التالي:

  • العبارة not updating HEAD تعني أن الأمر لم ينشئ أي Commit، وإنما وضع كل التغييرات في منطقة التجهيز Staging Area، وgit status --short يبين ذلك بالحرف M في العمود الأول، أي معدل وجاهز لل Commit.
  • أنت من ينشئ ال Commit برسالتك، ووضعنا فيها رقم طلب الدمج كما تفعل المنصات، حتى يعرف من يقرأ التاريخ أين يجد النقاش والمراجعة.
  • ال Commit c830269 على main له أب واحد هو 57f43bf، ولا يوجد أي خط بينه وبين ال Commits الثلاثة في الفرع، فالرسم يبين أن الفرع ما زال معلقاً بجانب main كأنه لم يدمج.

والنقطة الأخيرة لها أثر عملي يقع فيه كثيرون، فلنحاول أن نحذف الفرع بعد الدمج كما نفعل عادة:

git branch -d feature/discount
git branch -D feature/discount

والمخرج سوف يكون كما يلي:

error: the branch 'feature/discount' is not fully merged
hint: If you are sure you want to delete it, run 'git branch -D feature/discount'
hint: Disable this message with "git config set advice.forceDeleteBranch false"

Deleted branch feature/discount (was d70718f).

رفض Git حذف الفرع بالخيار -d لأنه يرى أن Commits الفرع لم تدخل main، وهو محق من جهة التاريخ، فالذي دخل main هو Commit جديد فيه التغييرات نفسها. ولذلك تحذف المنصات الفرع تلقائياً بعد Squash، وعلى جهازك تحذفه بالخيار -D بالحرف الكبير بعد أن تتأكد أن الطلب دمج فعلاً. والصورة التالية تلخص ما حدث:

رسم قبل وبعد: قبل الدمج طلب دمج رقم 12 فيه ثلاثة Commits برتقالية وزر Squash and merge، وبعده Commit واحد أخضر S برقم c830269 على main يحمل كل التغييرات، وCommits الفرع الثلاثة باللون الرمادي المتقطع خارج التاريخ
Squash يحول الطلب كله إلى Commit واحد في main، ويترك الفرع خارج التاريخ

ومتى تستخدمه؟ عندما يكون كل طلب دمج ميزة أو إصلاحاً واحداً، وهذا هو الحال في أغلب الفرق الصغيرة، فيصبح تاريخ main قائمة مقروءة من الطلبات، والتراجع عن طلب كامل يكون بالتراجع عن Commit واحد. ومتى لا تستخدمه؟ عندما يكون الطلب كبيراً فيه خطوات مستقلة تريد أن تبقى منفصلة في التاريخ، وعندما يكون الفرع طويل العمر وتريد أن تستمر عليه بعد الدمج، لأن Git لا يعرف أن Commits الفرع دخلت main، فإذا دمجته مرة أخرى فسوف يحاول أن يدخل التغييرات نفسها من جديد وقد تظهر تعارضات. ويذكر توثيق GitHub نقطتين أخريين: تفقد المعلومة عن متى كتب كل تغيير في الأصل ومن كتب كل Commit داخل الطلب، وإذا استمررت على الفرع نفسه بعد الدمج وفتحت طلباً جديداً فسوف تظهر فيه ال Commits التي دمجتها من قبل.

Merge أم Rebase أم Squash؟ المقارنة Comparison

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

مقارنة جانبية: على اليمين نتيجة git merge فيها خطان يلتقيان في Merge Commit اسمه M مع مخرج git log الذي يرسم الخطين، وعلى اليسار نتيجة git rebase ثم git merge وهي خط واحد مستقيم مع مخرج git log المستقيم، وتحت كل جانب نقاط القوة والضعف
الدمج يحفظ ما حدث كما حدث، وإعادة التأسيس تعطي خطاً واحداً بأرقام جديدة
MergeRebase ثم MergeSquash Merge
شكل تاريخ mainفروع تلتقي في Merge Commitsخط واحد، وكل Commit من الفرع يظهرخط واحد، وCommit واحد لكل طلب
هل يغير أرقام Commits موجودة؟لا، يضيف فقطنعم، Commits الفرع تنسخ بأرقام جديدةلا يغيرها، ولكنه لا يدخلها main أصلاً
على فرع مشتركآمن دائماًممنوعآمن عند الدمج في main
التعارضات Conflictsتحلها مرة واحدة في Merge Commitقد تحلها مرة لكل Commit يعاد تطبيقهمرة واحدة، مثل الدمج
التراجع عن الميزة كلهابالتراجع عن Merge Commit نفسهتحتاج أن تعرف أي Commits كانت الميزةبالتراجع عن Commit واحد
حذف الفرع بعدها بالخيار -dيقبليقبليرفض، وتحتاج -D
يحتاج من الفريقلا شيءفهم القاعدة الذهبيةلا شيء، والمنصة تفعله

وفي الجدول أعلاه، العمود الأول يناسب من يريد أن يحفظ ما حدث فعلاً، فالتاريخ لا يخفي شيئاً، ويبين متى فتح كل فرع ومتى اندمج، ولا يغير أي رقم فلا يعطل عمل أحد، ولكن Merge Commits تتكاثر وتجعل الرسم صعب القراءة في الفرق الكبيرة. والعمود الثاني يعطي تاريخاً نظيفاً كأن كل شيء كتب بالترتيب، وفرصة لترتيب عملك قبل المراجعة، ولكنه يعيد كتابة Commits الفرع، فهو خطير على أي فرع مشترك، والتاريخ الناتج لا يبين الترتيب الحقيقي الذي عمل به الناس. والعمود الثالث أبسطها على الفريق، ولكنه يخسر تفاصيل ال Commits داخل كل طلب.

والإجابة العملية أن أغلب الفرق لا تختار واحدة وتترك الأخريين، وإنما تستخدم كل واحدة في مكانها، وأشهر السياسات ثلاث:

  1. Squash عند دمج كل طلب: مهما كان عدد ال Commits في الفرع، يدخل main Commit واحد لكل طلب. وهذه أبسط سياسة لفريق صغير أو فريق فيه مبتدئون، ولا تحتاج من أحد أن يتقن Rebase.
  2. Rebase محلياً ثم Merge عبر الطلب: كل شخص ينفذ git pull --rebase ويرتب فرعه بالأمر rebase -i قبل فتح الطلب، ثم يدمج الطلب بMerge Commit أو بدمج سريع. وهذه تناسب فريقاً يهتم بأن يبقى كل Commit مفيداً في التاريخ.
  3. Merge دائماً: لا أحد يعيد كتابة أي شيء، والتاريخ كما حدث تماماً، وهذه تناسب الفرق التي تقدم الأمان والبساطة على شكل الرسم.

وأياً كانت السياسة، ففي كل الحالات يبقى git pull --rebase لCommitsك المحلية التي لم تدفعها اختياراً جيداً. وفي المنصات تفرض السياسة من إعدادات المستودع، ففي Gitea تختار في إعدادات كل مستودع طرق الدمج المسموحة في طلبات الدمج، والقيم التي يعرفها ملف الإعداد للخيار DEFAULT_MERGE_STYLE هي merge وrebase وrebase-merge وsquash وfast-forward-only، والافتراضي merge. وإذا سمحت بطريقة واحدة فقط فلن يحتار أحد أمام الزر.

التعارضات Conflicts: لماذا تحدث وكيف تحلها

إلى الآن نجح كل دمج تلقائياً، لأن كل طرف غير ملفات أو أسطراً مختلفة. ولكن ماذا لو غير شخصان السطر نفسه؟ هنا لا يستطيع Git أن يقرر عنك أي القيمتين صحيحة، فيتوقف ويطلب منك أن تقرر، وهذا هو التعارض Conflict. والتعارض ليس خطأ ولا عطلاً، وإنما سؤال من Git لك. وفي التجربة أنشأنا فرعاً اسمه feature/campaign غير نسبة الخصم من 0.10 إلى 0.20 لحملة تسويقية، وفي الوقت نفسه غير زميل على main النسبة نفسها إلى 0.15.

تعارض أثناء الدمج Merge Conflict

نقف على main وندمج الفرع، ثم نسأل Git عن الحالة وننظر في الملف:

git merge feature/campaign
git status
cat cart.py

والمخرج سوف يكون كما يلي:

Auto-merging cart.py
CONFLICT (content): Merge conflict in cart.py
Automatic merge failed; fix conflicts and then commit the result.

On branch main
You have unmerged paths.
  (fix conflicts and run "git commit")
  (use "git merge --abort" to abort the merge)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   cart.py

no changes added to commit (use "git add" and/or "git commit -a")

def price(item):
    return item["price"] * item["qty"]

<<<<<<< HEAD
RATE = 0.15
=======
RATE = 0.20
>>>>>>> feature/campaign

def discount(total):
    return total * (1 - RATE)

في المخرج أعلاه لاحظ التالي:

  • السطر CONFLICT (content) يحدد الملف، وAutomatic merge failed يعني أن الدمج توقف في المنتصف ولم ينشئ أي Commit بعد.
  • git status هو صديقك في كل تعارض، فهو يخبرك أين أنت، وما الملفات التي فيها تعارض تحت Unmerged paths، وعبارة both modified تعني أن الطرفين غيرا الملف نفسه، ويخبرك بالخطوة التالية وبطريقة الإلغاء.
  • داخل الملف وضع Git كتلتين: من <<<<<<< HEAD إلى ======= النسخة التي في الفرع الذي تقف عليه، أي main، وتسمى أيضاً Ours، ومن ======= إلى >>>>>>> feature/campaign النسخة القادمة من الفرع الآخر، وتسمى Theirs.
  • بقية الملف خارج العلامات لم يتعارض، وقد جمعه Git كالمعتاد.

وإذا شعرت أنك لست مستعداً للحل الآن، أو أن الدمج كان خطأ أصلاً، فالأمر التالي يرجع كل شيء إلى ما كان عليه قبل git merge، وgit status --short بعده لا يطبع شيئاً، أي أن المجلد نظيف:

git merge --abort
git status --short

اعرف الأصل أيضاً: merge.conflictStyle zdiff3

الكتلتان السابقتان تخبرانك بما يريده كل طرف، ولكنهما لا تخبرانك بما كان عليه السطر قبل أن يغيره أي منهما، وهذا مهم في الحل: إذا كانت القيمة الأصلية 0.10، فأنت تعرف أن الطرفين رفعا الخصم، وأن السؤال هو بكم. والإعداد merge.conflictStyle بالقيمة zdiff3، وهو من إعدادات git config، يضيف كتلة ثالثة في الوسط فيها الأصل المشترك. أعدنا الدمج بعد أن فعلناه:

git config merge.conflictStyle zdiff3
git merge feature/campaign
cat cart.py

والمخرج سوف يكون كما يلي:

Auto-merging cart.py
CONFLICT (content): Merge conflict in cart.py
Automatic merge failed; fix conflicts and then commit the result.

def price(item):
    return item["price"] * item["qty"]

<<<<<<< HEAD
RATE = 0.15
||||||| 320d164
RATE = 0.10
=======
RATE = 0.20
>>>>>>> feature/campaign

def discount(total):
    return total * (1 - RATE)

الكتلة الجديدة بين ||||||| 320d164 و======= هي السطر كما كان في الأصل المشترك 320d164، وهو آخر Commit قبل أن يتباعد الفرعان. والآن نحل التعارض، والحل قرار بشري: الحملة لم تعتمد بعد، فنبقي قيمة main وهي 0.15. والحل يعني أن تعدل الملف حتى يصبح كما تريده تماماً، وتحذف كل أسطر العلامات، ثم تخبر Git أن الملف جاهز بالأمر git add، ثم تنهي الدمج:

cat cart.py
git add cart.py
git commit --no-edit
git log --oneline --graph -n 4

والمخرج سوف يكون كما يلي:

def price(item):
    return item["price"] * item["qty"]

RATE = 0.15

def discount(total):
    return total * (1 - RATE)

[main 94ab129] Merge branch 'feature/campaign'

*   94ab129 Merge branch 'feature/campaign'
|\
| * ab22783 Campaign discount 20%
* | 39a5d27 Raise discount to 15%
|/
* 320d164 Document discount

الملف أصبح نظيفاً دون أي علامة، والخيار --no-edit يقبل رسالة الدمج الجاهزة، والرسم يبين أن Merge Commit يربط الفرعين كأي دمج ثلاثي. ولاحظ أن Git لا يفحص هل ما كتبته صحيح، فإذا نسيت سطراً من العلامات وأضفت الملف فسوف يقبله ويدخل الخطأ إلى المستودع، لذلك ابحث في الملف عن <<<<<<< قبل git add، وشغل الاختبارات قبل أن تدفع.

تعارض أثناء إعادة التأسيس: لماذا ينعكس HEAD؟

الآن الموقف نفسه، ولكنك صاحب الفرع feature/campaign، وفيه Commitان: الأول يغير النسبة إلى 0.20، والثاني يوثق الحملة في README. وقررت أن تعيد تأسيس فرعك على main قبل الطلب كما ينصحك الفريق:

git switch feature/campaign
git rebase main
git status
cat cart.py

والمخرج سوف يكون كما يلي:

Auto-merging cart.py
CONFLICT (content): Merge conflict in cart.py
error: could not apply 4c22e9b... Campaign discount 20%
hint: Resolve all conflicts manually, mark them as resolved with
hint: "git add/rm <conflicted_files>", then run "git rebase --continue".
hint: You can instead skip this commit: run "git rebase --skip".
hint: To abort and get back to the state before "git rebase", run "git rebase --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Could not apply 4c22e9b... # Campaign discount 20%

interactive rebase in progress; onto 1061318
Last command done (1 command done):
   pick 4c22e9b # Campaign discount 20%
Next command to do (1 remaining command):
   pick 85828e7 # Document the campaign
  (use "git rebase --edit-todo" to view and edit)
You are currently rebasing branch 'feature/campaign' on '1061318'.
  (fix conflicts and then run "git rebase --continue")
  (use "git rebase --skip" to skip this patch)
  (use "git rebase --abort" to check out the original branch)

Unmerged paths:
  (use "git restore --staged <file>..." to unstage)
  (use "git add <file>..." to mark resolution)
	both modified:   cart.py

no changes added to commit (use "git add" and/or "git commit -a")

def price(item):
    return item["price"] * item["qty"]

<<<<<<< HEAD
RATE = 0.15
=======
RATE = 0.20
>>>>>>> 4c22e9b (Campaign discount 20%)

def discount(total):
    return total * (1 - RATE)

هذا المخرج طويل، ولكن كل سطر فيه يفيدك، فلنقرأه بهدوء:

  • إعادة التأسيس توقفت عند ال Commit الأول 4c22e9b لأنه لا يمكن تطبيقه فوق main دون قرار منك، وتعطيك ثلاثة خيارات: أن تحل وتكمل بالأمر --continue، أو تتخطى هذا ال Commit كله بالأمر --skip، أو تلغي العملية كلها وترجع إلى فرعك كما كان بالأمر --abort.
  • git status يخبرك أين أنت في القائمة: نفذ أمر واحد، وبقي أمر واحد هو ال Commit الثاني. والعبارة interactive rebase in progress تظهر حتى في إعادة التأسيس العادية، لأن Git يستخدم آلية القائمة نفسها داخلياً.
  • والنقطة الأهم التي تربك المبتدئين: الكتلة تحت HEAD هنا هي 0.15، أي قيمة main، وليست قيمة فرعك. والكتلة الثانية هي ال Commit الخاص بك 4c22e9b. والسبب أن إعادة التأسيس تبدأ بالوقوف على main ثم تطبق Commitsك فوقه واحداً بعد الآخر، فما «عندك الآن» هو main، وما «يأتي» هو عملك.

والصورة التالية تضع الحالتين جنباً إلى جنب، لأن هذا الانعكاس يغير معنى الخيارين --ours و--theirs أيضاً: في الدمج يأخذ git checkout --ours نسخة فرعك الحالي، أما أثناء إعادة التأسيس فيأخذ نسخة main:

لوحتان: في الدمج git merge feature/campaign تظهر كتلة HEAD بقيمة 0.15 وهي main وكتلة الأصل بقيمة 0.10 ثم كتلة الفرع بقيمة 0.20، وفي إعادة التأسيس git rebase main تظهر كتلة HEAD بقيمة 0.15 وهي main وليس فرعك ثم كتلة ال Commit الخاص بك 4c22e9b بقيمة 0.20، وتحتهما الخطوات الثلاث لإنهاء التعارض
في الدمج HEAD هو الفرع الذي تقف عليه، وفي إعادة التأسيس HEAD هو main الذي تبني فوقه

والحل هنا أن نبقي قيمة الحملة 0.20، لأن هذا هو عمل الفرع الذي سوف يناقش في الطلب، ثم نكمل:

git add cart.py
git rebase --continue
git log --oneline --graph --all -n 6

والمخرج سوف يكون كما يلي:

[detached HEAD 3a6dc9e] Campaign discount 20%
 1 file changed, 1 insertion(+), 1 deletion(-)
Successfully rebased and updated refs/heads/feature/campaign.

* 564ae7a Document the campaign
* 3a6dc9e Campaign discount 20%
* 1061318 Raise discount to 15%
* 320d164 Document discount
* 2fb0d79 Add discount
* 57f43bf Add README

بعد --continue أنشأ Git ال Commit الأول بالحل الذي كتبناه، ثم طبق ال Commit الثاني الذي يغير README فقط دون أي تعارض، فانتهت العملية، والفرع الآن خط مستقيم فوق «Raise discount to 15%». ولو كان ال Commit الثاني يغير السطر نفسه أيضاً لتوقف Git مرة ثانية، وهذا معنى ما ذكرناه في الجدول: في إعادة التأسيس قد تحل التعارض مرة لكل Commit، أما في الدمج فمرة واحدة. وإذا كان في فرعك عشرون Commit تغير الملف نفسه، فقد يكون الدمج أو Squash أريح من إعادة التأسيس.

الأمر rerere: لا تحل التعارض نفسه مرتين

قد تحل تعارضاً، ثم تلغي الدمج لسبب ما، أو تعيد تأسيس الفرع مرة أخرى بعد أسبوع، فيظهر لك التعارض نفسه وتحله من جديد. والاسم rerere اختصار لعبارة Reuse Recorded Resolution، أي أعد استخدام الحل المسجل، وعندما تفعله يحفظ Git شكل كل تعارض وحلك له، فإذا ظهر التعارض نفسه مرة أخرى طبق الحل تلقائياً. جربناه بأن فعلناه، ثم دمجنا وحللنا، ثم ألغينا الدمج بالأمر reset ودمجنا مرة أخرى:

git config rerere.enabled true
git merge feature/campaign
git add cart.py
git commit --no-edit
git reset -q --hard HEAD~1
git merge feature/campaign
cat cart.py

والمخرج سوف يكون كما يلي:

Auto-merging cart.py
CONFLICT (content): Merge conflict in cart.py
Recorded preimage for 'cart.py'
Automatic merge failed; fix conflicts and then commit the result.

Recorded resolution for 'cart.py'.
[main 381652e] Merge branch 'feature/campaign'

Auto-merging cart.py
CONFLICT (content): Merge conflict in cart.py
Resolved 'cart.py' using previous resolution.
Automatic merge failed; fix conflicts and then commit the result.

def price(item):
    return item["price"] * item["qty"]

RATE = 0.15

def discount(total):
    return total * (1 - RATE)

في الدمج الأول سجل Git شكل التعارض Recorded preimage، وعند ال Commit سجل الحل Recorded resolution. وفي الدمج الثاني ظهر التعارض كالعادة، ولكن السطر Resolved 'cart.py' using previous resolution يقول إن Git طبق الحل السابق بنفسه، والملف نظيف وفيه 0.15. ولاحظ أن Git ما زال يقول إن الدمج توقف، لأنه يريد منك أن تراجع الحل ثم تنفذ git add بنفسك، فهو لا يفترض أن الحل القديم صحيح دائماً. وهذا مفيد جداً لمن يعيد تأسيس فرع طويل أكثر من مرة، وتستطيع أن تفعله لكل مستودعاتك بالخيار --global، والتفاصيل في توثيق git rerere.

كيف تقلل التعارضات من الأساس؟ Fewer Conflicts

التعارض لا يمكن منعه تماماً، فهو نتيجة طبيعية لعمل أكثر من شخص على الكود نفسه، ولكن حجمه بيدك. وكل ما يقلله يرجع إلى فكرة واحدة: كلما قصرت المدة بين فتح الفرع ودمجه قل ما يتغير في main خلالها. لذلك اجعل الطلبات صغيرة تدمج في يوم أو يومين بدلاً من فرع يعيش أسابيع، واسحب main إلى فرعك بانتظام بالدمج أو بإعادة التأسيس بحسب سياسة الفريق، ولا تخلط في طلب واحد تغيير سلوك مع إعادة تنسيق ملف كامل، لأن إعادة التنسيق تلمس كل الأسطر فتتعارض مع عمل كل زملائك. واتفق مع الفريق على أداة تنسيق Formatter تعمل تلقائياً، حتى لا يكون اختلاف المسافات سبباً لتعارض. وهذه الفكرة هي أساس طريقة التطوير على الفرع الرئيسي Trunk-Based.

الدفع بالقوة الآمن Force with Lease

بعد إعادة تأسيس فرعك الشخصي أو ترتيبه بالأمر rebase -i أو تعديل آخر Commit فيه، وكنت قد دفعته من قبل، سوف يرفض السيرفر الدفع العادي، لأن تاريخك لم يعد امتداداً لتاريخه، كما رأينا مع علي. وهنا تحتاج الدفع بالقوة، ولكن --force يكتب نسختك فوق ما على السيرفر مهما كان، فإذا كان أحد قد دفع إلى الفرع نفسه بعد آخر مرة نظرت فيها فسوف يحذف عمله دون أي تحذير. والخيار --force-with-lease يضيف شرطاً: لا تكتب فوق الفرع إلا إذا كان على السيرفر ما زال كما رأيته آخر مرة.

وفي التجربة عدل علي آخر Commit في الفرع بالأمر git commit --amend، وفي الوقت نفسه أضافت سارة Commit مراجعة صغيراً ودفعته إلى الفرع نفسه:

git push --force-with-lease origin feature/shared

والمخرج سوف يكون كما يلي:

To /work/remote.git
 ! [rejected]        feature/shared -> feature/shared (stale info)
error: failed to push some refs to '/work/remote.git'

الرفض بالسبب stale info يعني أن معلوماتك قديمة، فالسيرفر تغير منذ آخر مرة جلبت منه، وهذا بالضبط ما نريده، فCommit سارة محمي. ولكن هنا يقع خطأ حقيقي يقع فيه كثيرون، وقد وقعنا فيه عمداً في التجربة: الرسالة توحي بأن الحل أن تجلب، فنجلب ونعيد المحاولة:

git fetch origin
git push --force-with-lease --force-if-includes origin feature/shared
git push --force-with-lease origin feature/shared

والمخرج سوف يكون كما يلي:

From /work/remote
   e4b7963..153ae2e  feature/shared -> origin/feature/shared

To /work/remote.git
 ! [rejected]        feature/shared -> feature/shared (remote ref updated since checkout)
error: failed to push some refs to '/work/remote.git'
hint: Updates were rejected because the tip of the remote-tracking branch has
hint: been updated since the last checkout. If you want to integrate the
hint: remote changes, use 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

To /work/remote.git
 + 153ae2e...69cdda3 feature/shared -> feature/shared (forced update)

في المخرج أعلاه لاحظ التالي:

  • الأمر git fetch جلب Commit سارة 153ae2e، فأصبح Git «يعرف» الحالة الجديدة للسيرفر، مع أننا لم ندخل Commit سارة في فرعنا.
  • مع الخيار --force-if-includes رفض الدفع مرة أخرى، لأن هذا الخيار يتحقق أن ما جلبته دخل فعلاً في فرعك، وهو لم يدخل.
  • أما المحاولة الأخيرة بالخيار --force-with-lease وحده فنجحت، وحذفت Commit سارة 153ae2e من السيرفر، والسبب أن الجلب حدث الحالة التي يقارن بها الخيار، فظن أنك رأيت عمل سارة وقررت أن تكتب فوقه. وهذا التحذير مذكور صراحة في توثيق git push، ويصبح أخطر مع المحررات التي تنفذ git fetch في الخلفية تلقائياً كل بضع دقائق.

والطريقة الصحيحة بعد الرفض الأول أن تدخل عمل سارة في فرعك أولاً، بالأمر git pull --rebase لأنه فرعكما المشترك الآن، ثم تدفع دفعاً عادياً. أما الصيغة التي ننصح بها عندما تحتاج الدفع بالقوة إلى فرعك الشخصي فهي git push --force-with-lease --force-if-includes معاً، ولا تقم بالدفع بالقوة إلى main أو أي فرع مشترك بأي صيغة، واجعل حماية الفروع على السيرفر تمنع ذلك حتى لا تعتمد على ذاكرة أحد.

أخطاء شائعة Common Mistakes

  • الدمج وأنت على الفرع الخطأ: نفذت git merge main وأنت تظن أنك على main، فدخل main في فرعك. نفذ git status أو انظر إلى السطر الأول منه قبل كل دمج، ويخبرك على أي فرع أنت.
  • Rebase لفرع مشترك ثم --force: رأينا نتيجته في تجربة علي وسارة، والعلامة التي تبين أنه حدث أن ترى Commits مكررة بالرسالة نفسها وأرقام مختلفة بعد السحب.
  • إضافة ملف ما زالت فيه علامات التعارض: Git لا يفحص المحتوى، فابحث عن <<<<<<< قبل git add، وشغل الاختبارات.
  • الخلط بين --ours و--theirs أثناء إعادة التأسيس: تذكر أن ours هنا main، وأن عملك هو theirs.
  • Squash ثم الاستمرار على الفرع نفسه: Git لا يعرف أن Commitsه دخلت main، فافتح فرعاً جديداً من main بعد كل دمج.
  • الخوف من --abort: إذا ضعت في منتصف دمج أو إعادة تأسيس، فالأمر git merge --abort أو git rebase --abort يرجعك إلى ما كنت عليه تماماً، فلا تحاول إصلاح وضع لا تفهمه بأوامر عشوائية.
  • فرع يعيش أسابيع: كل يوم إضافي يزيد التعارضات يوم الدمج، فقسم العمل إلى طلبات صغيرة.

الموقف والأمر Cheat Sheet

الموقفالأمرهل يغير أرقام Commits موجودة؟
دمج فرع ميزة مع إبقاء أثره في التاريخgit merge --no-ff featureلا
تحديث فرعك المحلي من السيرفر دون Merge Commitgit merge --ff-only origin/mainلا
سحب عمل الزملاء فوق Commitsك المحليةgit pull --rebaseنعم، لCommitsك المحلية فقط
نقل فرعك الشخصي فوق آخر maingit rebase mainنعم
ترتيب Commitsك قبل طلب الدمجgit rebase -i mainنعم
Commit يصلح Commit سابقاًgit commit --fixup=<hash> ثم git rebase -i --autosquash mainنعم
طلب كامل في Commit واحدgit merge --squash feature ثم git commitلا
إلغاء دمج أو إعادة تأسيس في المنتصفgit merge --abort أو git rebase --abortلا
إكمال إعادة التأسيس بعد حل التعارضgit add <file> ثم git rebase --continueنعم
رؤية الأصل في التعارضgit config --global merge.conflictStyle zdiff3لا
إعادة استخدام حلول التعارضاتgit config --global rerere.enabled trueلا
الدفع إلى فرعك بعد إعادة تأسيسهgit push --force-with-lease --force-if-includesنعم، على السيرفر

تدريب عملي Practice

  1. شغل ال Container كما في بداية المقال، وأنشئ مستودعاً فيه Commitان على main وفرع بCommitين، ثم ادمجه بالطرق الثلاث في ثلاث نسخ من المستودع، وقارن مخرج git log --oneline --graph --all في كل نسخة.
  2. في نسخة رابعة أضف Commit إلى main ثم نفذ git merge --ff-only واقرأ الرسالة، ثم نفذ git cat-file -p على Merge Commit وعد سطور parent.
  3. اصنع تعارضاً بتغيير السطر نفسه في الفرعين، وحله مرة بالدمج ومرة بإعادة التأسيس، وفي كل مرة لاحظ أي قيمة تظهر تحت HEAD.
  4. أنشئ فرعاً بخمسة Commits منها «WIP» و«fix typo»، ورتبها بالأمر git rebase -i إلى Commitين، ثم استخدم git reflog لترى أين ذهبت ال Commits القديمة.

ماذا تقرأ بعد ذلك؟ Next Steps

دليلالتراجع عن الأخطاء في Git: revert أم reset أم restore؟لكل خطأ في Git أمر تراجع يناسب المكان الذي وصل إليه، وهنا تتعلم أن تختاره بسؤال واحد، وأن تسترجع عملاً ظننت أنه ضاع.دليلالتبديل بين المهام في Git: Stash أم Worktree؟عندما يأتيك طلب عاجل وأنت في منتصف ميزة، تحفظ عملك جانباً بالأمر stash أو تفتح له مجلداً ثانياً بالأمر worktree، وهنا تتعلم الاثنين خطوة بخطوة ومتى تختار كل واحد.دليلCherry-pick مع git bisect: نقل الإصلاح وإيجاد الخطأكيف تنقل إصلاحاً واحداً إلى الإصدار الذي يعمل عند العميل دون بقية التغييرات وتضع له وسماً، وكيف تجد الـ Commit الذي أدخل الخطأ بين عشرات الـ Commits في دقائق.دليلمراجعة الكود Code Review: كيف تراجع Pull Request بفائدةكيف تفتح طلب دمج يسهل على زميلك مراجعته، وكيف تراجع طلب غيرك بتعليقات تحسن الكود دون أن تتحول إلى موافقة شكلية أو جدال، مع حماية الفرع main في Gitea.

إذا دمجت شيئاً ثم ندمت عليه، أو نفذت reset --hard وظننت أن عملك ضاع، فاقرأ التراجع عن الأخطاء في Git. وإذا جاءك طلب عاجل وأنت في منتصف ميزة فاقرأ التبديل بين المهام في Git، وإذا احتجت أن تنقل إصلاحاً واحداً إلى فرع إصدار دون بقية main فاقرأ Cherry-pick مع git bisect. والصورة الكاملة لكل هذه المواضيع، مع استراتيجيات التفرع، في Git في العمل اليومي.

الخلاصة Summary

  • الفرع مؤشر إلى Commit، وكل أمر في هذا المقال إما ينشئ Commits وإما يحرك مؤشراً، والسؤال المهم دائماً: هل غير رقم Commit موجود؟
  • الدمج يضيف ولا يغير، فهو آمن على كل الفروع، والدمج السريع يحرك المؤشر فقط، والدمج الثلاثي أو --no-ff ينشئ Merge Commit له أبوان يحفظ أثر الفرع.
  • إعادة التأسيس تنسخ Commits فرعك فوق main بأرقام جديدة، فاستخدمها لعملك المحلي ولفرعك الشخصي فقط، ولا تقم بها على فرع سحبه غيرك، وإلا ظهرت ال Commits نفسها مرتين عند زملائك.
  • git pull --rebase هو أفضل استخدام يومي لإعادة التأسيس، وgit rebase -i يرتب عملك قبل المراجعة، وSquash يعطي main Commit واحداً لكل طلب دون أن يتقن الفريق Rebase.
  • التعارض سؤال من Git وليس عطلاً: اقرأ git status، وفعل zdiff3 لترى الأصل، وتذكر أن HEAD في إعادة التأسيس هو main، و--abort يرجعك دائماً إلى البداية.
  • ادفع بالقوة إلى فرعك الشخصي فقط، وبالصيغة --force-with-lease --force-if-includes، واجعل حماية الفروع على السيرفر تمنع الدفع بالقوة إلى main.

سجل التحديثات Changelog

  • نوفمبر 2026: كتابة المقال، وتنفيذ كل الأمثلة على git 2.54.0 داخل Container من alpine:3.24، مع مستودع Bare محلي لأمثلة الدفع والسحب بين شخصين. ويأخذ المقال قسم الدمج وإعادة التأسيس والتعارضات من دليل Git في العمل اليومي بعد تقسيمه إلى أربعة مقالات.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.