> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# Merge أم Rebase أم Squash؟ دمج الفروع في Git خطوة بخطوة
- URL: https://arabroot.io/articles/merge-ام-rebase-ام-squash-دمج-الفروع-في-git/
- Published: 2026-11-03T12:31:11.000Z
- Updated: 2026-11-03T13:31:23.000Z
- Description: ثلاث طرق لإدخال عمل فرعك إلى main، نجربها على المستودع نفسه حتى ترى بعينك ماذا تفعل كل واحدة بالتاريخ، ومتى تختارها، وكيف تحل التعارض في كل منها.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, DevOps والتشغيل, DevOps وCI/CD, الاستضافة الذاتية

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

وقد شرحنا في [إدارة النسخ مع Git للمبتدئين](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D9%88-git-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/) ما هو ال Commit والفرع Branch ومنطقة التجهيز، وفي [أول مستودع Git لك](https://arabroot.io/articles/%D8%A7%D9%88%D9%84-%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-git-%D9%84%D9%83-%D9%85%D9%86-git-init-%D8%A7%D9%84%D9%89-%D8%A7%D9%88%D9%84-push-%D8%B9%D9%84%D9%89-gitea/) أنشأنا مستودعاً ودفعناه إلى 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 بدلاً من جهازك مباشرة أن كل شيء يختفي عند حذفه، فإذا أخطأت في أمر فلن يتأثر أي ملف عندك:

```bash
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 "team@example.com"
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 ثان. والأوامر التي أنشأت هذا المستودع موجودة كاملة في ملف المختبر مع المقال، وهذا هو شكل التاريخ في البداية:

```bash
git log --oneline --graph --all
```

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

```bash
* 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 من الفرع](https://arabroot.io/content/images/2026/11/git-merge-rebase-01-ff-three-way.webp)

الدمج السريع يحرك المؤشر فقط، والدمج الثلاثي ينشئ Merge Commit يربط التاريخين

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

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

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

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

```bash
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 زميلك. لنر الشكل قبل الدمج ثم ندمج:

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

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

```bash
* 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` اسم الخوارزمية التي جمعت التغييرات، وهي [الخوارزمية الافتراضية](https://git-scm.com/docs/merge-strategies?ref=arabroot.io) عند دمج فرع واحد، ولا تحتاج أن تفعل معها أي شيء.
- نتج Commit جديد رقمه ed8083c ورسالته «Merge branch 'feature/discount'»، وهذا هو التزام الدمج Merge Commit، والخطان اللذان يلتقيان عنده في الرسم يعنيان أن له أبوين.

وإذا أردت أن ترى بنفسك أن هذا ال Commit له أبوان، فاطلب من Git أن يطبعه كما هو مخزن في المستودع بالأمر [git cat-file](https://git-scm.com/docs/git-cat-file?ref=arabroot.io):

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

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

```bash
tree c7834c959afd305bbfb9ec836d098335dd1c38fe
parent 2b7da1f98623c459863030b4bf83d04ec2e0878d
parent 320d164be096bab4767cd3c1d31800f46743c181
author ArabRoot Team <team@example.com> 1793686260 +0300
committer ArabRoot Team <team@example.com> 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](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github?ref=arabroot.io) وفي Gitea. ونفذناه على نسخة جديدة لم يتحرك فيها main:

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

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

```bash
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 من عندك. وهذا ما حدث عندما جربناه على النسخة التي تباعد فيها الفرعان:

```bash
git merge --ff-only feature/discount
```

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

```bash
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:

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

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

```bash
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، وتحت الرسم أربع خطوات مرقمة](https://arabroot.io/content/images/2026/11/git-merge-rebase-02-rebase.webp)

إعادة التأسيس تنسخ Commits الفرع فوق main بأرقام جديدة، والقديمة تبقى في reflog فقط

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

```bash
git reflog -n 6 feature/discount
```

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

```bash
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](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/).

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

```bash
git switch main
git merge feature/discount
```

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

```bash
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 [القاعدة](https://git-scm.com/book/en/v2/Git-Branching-Rebasing?ref=arabroot.io) بوضوح: لا تقم بإعادة تأسيس Commits موجودة خارج مستودعك وقد يكون غيرك بنى عليها. ولكن القاعدة تبقى نظرية حتى ترى ما يحدث فعلاً، لذلك جربناها: أنشأنا مستودعاً على السيرفر Bare Repository داخل ال Container، ونسختين منه لشخصين، علي وسارة. علي فتح فرعاً مشتركاً اسمه `feature/shared` فيه Commitان للخصم ودفعه، وسارة سحبته وأضافت فوقه Commit «Add coupon» لم تدفعه بعد. ثم أضاف علي Commit إلى main، وقرر أن يعيد تأسيس الفرع المشترك عليه:

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

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

```bash
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` تعنيان أن تاريخ الفرع على السيرفر أعيدت كتابته. والآن سارة تسحب الفرع كعادتها:

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

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

```bash
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`، ثم أنهت الدمج، وهذا هو التاريخ عندها الآن:

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

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

```bash
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 لم يرها غيرك](https://arabroot.io/content/images/2026/11/git-merge-rebase-06-golden-rule.webp)

إعادة تأسيس فرع مشترك تجعل ال Commits نفسها تظهر مرتين عند كل من سحبه

🛑

لا تقم بعمل Rebase لفرع مشترك مثل main أو develop، ولا لفرع دفعته وسحبه زميلك. والمسموح أن تعيد تأسيس Commits محلية لم تدفعها بعد، أو فرعك الشخصي الذي لا يعمل عليه أحد غيرك. وإذا رفض السيرفر الدفع بعد Rebase، فتوقف واسأل نفسك هل يعمل أحد على هذا الفرع قبل أن تضيف `--force`.

وكيف تخرج سارة من هذا الموقف إذا وقعت فيه؟ الطريقة الأنظف أن تلغي الدمج قبل أن تنهيه بالأمر `git merge --abort`، ثم تنقل Commit «Add coupon» وحده فوق النسخة الجديدة من الفرع، وهذا ما تفعله إعادة التأسيس نفسها إذا نفذت `git pull --rebase` بدلاً من الدمج، لأن Git يتعرف على ال Commits التي لها التغيير نفسه فيتخطاها. ولكن الحل الحقيقي ألا يحدث هذا أصلاً: الفرع المشترك يدمج فقط، والسيرفر يمنع الدفع بالقوة إلى الفروع المهمة بحماية الفروع Branch Protection، وقد شرحناها في [مراجعة الكود Code Review](https://arabroot.io/articles/%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D9%83%D9%88%D8%AF-code-review-%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-pull-request-%D8%A8%D9%81%D8%A7%D8%A6%D8%AF%D8%A9/).

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

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

```bash
git push origin main
git pull origin main
```

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

```bash
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 علي المحلي لم يره أحد بعد، فلا يوجد من بنى عليه:

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

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

```bash
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 لا يحمل أي معلومة، سوى أن شخصين دفعا في اليوم نفسه. ولكي يصبح هذا هو السلوك الدائم دون أن تكتب الخيار كل مرة، نفذ مرة واحدة على جهازك:

```bash
git config --global pull.rebase true
```

ويذكر [توثيق git pull](https://git-scm.com/docs/git-pull?ref=arabroot.io) هذا الإعداد وبدائله. وإذا ظهر تعارض أثناء السحب بهذه الطريقة فإن Git يتوقف عند ال Commit الذي فيه التعارض، فتحله كما سوف نشرح في [قسم التعارضات](#conflicts)، ثم تكمل بالأمر `git rebase --continue`، أو تلغي العملية كلها وترجع إلى ما كنت عليه بالأمر `git rebase --abort`.

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

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

```bash
git log --oneline
```

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

```bash
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 ثم نفذها دون تغيير:

```bash
GIT_SEQUENCE_EDITOR=cat git rebase -i main
```

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

```bash
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 بعد التعديل:

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

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

```bash
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
```

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

```bash
[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 بواحد:

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

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

```bash
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` نظيفاً:

```bash
git log --oneline
```

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

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

وقاعدة الأمان في إعادة التأسيس التفاعلية هي القاعدة الذهبية نفسها، فهي تعيد كتابة ال Commits، لذلك نفذها على فرعك قبل أن تفتح طلب الدمج، وإذا كنت قد دفعت الفرع من قبل فسوف يرفض السيرفر الدفع العادي، وتحتاج الدفع بالقوة الآمن الذي نشرحه في [آخر المقال](#force-with-lease).

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

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

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

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

```bash
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 كأنه لم يدمج.

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

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

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

```bash
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 الفرع الثلاثة باللون الرمادي المتقطع خارج التاريخ](https://arabroot.io/content/images/2026/11/git-merge-rebase-04-squash.webp)

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 المستقيم، وتحت كل جانب نقاط القوة والضعف](https://arabroot.io/content/images/2026/11/git-merge-rebase-03-merge-vs-rebase.webp)

الدمج يحفظ ما حدث كما حدث، وإعادة التأسيس تعطي خطاً واحداً بأرقام جديدة

|                               | Merge                           | Rebase ثم Merge                      | Squash 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 تختار في إعدادات كل مستودع طرق الدمج المسموحة في طلبات الدمج، والقيم التي يعرفها [ملف الإعداد](https://docs.gitea.com/administration/config-cheat-sheet?ref=arabroot.io) للخيار `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 عن الحالة وننظر في الملف:

```bash
git merge feature/campaign
git status
cat cart.py
```

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

```bash
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` بعده لا يطبع شيئاً، أي أن المجلد نظيف:

```bash
git merge --abort
git status --short
```

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

الكتلتان السابقتان تخبرانك بما يريده كل طرف، ولكنهما لا تخبرانك بما كان عليه السطر قبل أن يغيره أي منهما، وهذا مهم في الحل: إذا كانت القيمة الأصلية 0.10، فأنت تعرف أن الطرفين رفعا الخصم، وأن السؤال هو بكم. والإعداد `merge.conflictStyle` بالقيمة `zdiff3`، وهو من إعدادات [git config](https://git-scm.com/docs/git-config?ref=arabroot.io)، يضيف كتلة ثالثة في الوسط فيها الأصل المشترك. أعدنا الدمج بعد أن فعلناه:

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

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

```bash
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`، ثم تنهي الدمج:

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

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

```bash
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 قبل الطلب كما ينصحك الفريق:

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

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

```bash
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، وتحتهما الخطوات الثلاث لإنهاء التعارض](https://arabroot.io/content/images/2026/11/git-merge-rebase-05-conflict.webp)

في الدمج HEAD هو الفرع الذي تقف عليه، وفي إعادة التأسيس HEAD هو main الذي تبني فوقه

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

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

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

```bash
[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` ودمجنا مرة أخرى:

```bash
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
```

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

```bash
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](https://git-scm.com/docs/git-rerere?ref=arabroot.io).

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

التعارض لا يمكن منعه تماماً، فهو نتيجة طبيعية لعمل أكثر من شخص على الكود نفسه، ولكن حجمه بيدك. وكل ما يقلله يرجع إلى فكرة واحدة: كلما قصرت المدة بين فتح الفرع ودمجه قل ما يتغير في main خلالها. لذلك اجعل الطلبات صغيرة تدمج في يوم أو يومين بدلاً من فرع يعيش أسابيع، واسحب main إلى فرعك بانتظام بالدمج أو بإعادة التأسيس بحسب سياسة الفريق، ولا تخلط في طلب واحد تغيير سلوك مع إعادة تنسيق ملف كامل، لأن إعادة التنسيق تلمس كل الأسطر فتتعارض مع عمل كل زملائك. واتفق مع الفريق على أداة تنسيق Formatter تعمل تلقائياً، حتى لا يكون اختلاف المسافات سبباً لتعارض. وهذه الفكرة هي أساس طريقة [التطوير على الفرع الرئيسي Trunk-Based](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B7%D9%88%D9%8A%D8%B1-%D8%B9%D9%84%D9%89-%D8%A7%D9%84%D9%81%D8%B1%D8%B9-%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A-trunk-based/).

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

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

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

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

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

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

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

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

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

```bash
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](https://git-scm.com/docs/git-push?ref=arabroot.io)، ويصبح أخطر مع المحررات التي تنفذ `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 Commit | git merge --ff-only origin/main                              | لا                            |
| سحب عمل الزملاء فوق Commitsك المحلية          | git pull --rebase                                            | نعم، لCommitsك المحلية فقط    |
| نقل فرعك الشخصي فوق آخر main                  | git 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

[![](https://arabroot.io/content/images/2026/11/git-undo-cover-cover.webp)دليلالتراجع عن الأخطاء في Git: revert أم reset أم restore؟لكل خطأ في Git أمر تراجع يناسب المكان الذي وصل إليه، وهنا تتعلم أن تختاره بسؤال واحد، وأن تسترجع عملاً ظننت أنه ضاع.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/)[![](https://arabroot.io/content/images/2026/11/git-stash-worktree-cover-cover.webp)دليلالتبديل بين المهام في Git: Stash أم Worktree؟عندما يأتيك طلب عاجل وأنت في منتصف ميزة، تحفظ عملك جانباً بالأمر stash أو تفتح له مجلداً ثانياً بالأمر worktree، وهنا تتعلم الاثنين خطوة بخطوة ومتى تختار كل واحد.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%A8%D8%AF%D9%8A%D9%84-%D8%A8%D9%8A%D9%86-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%81%D9%8A-git-stash-%D8%A7%D9%85-worktree/)[![](https://arabroot.io/content/images/2026/11/git-cherry-pick-bisect-cover-cover.webp)دليلCherry-pick مع git bisect: نقل الإصلاح وإيجاد الخطأكيف تنقل إصلاحاً واحداً إلى الإصدار الذي يعمل عند العميل دون بقية التغييرات وتضع له وسماً، وكيف تجد الـ Commit الذي أدخل الخطأ بين عشرات الـ Commits في دقائق.](https://arabroot.io/articles/cherry-pick-%D9%85%D8%B9-git-bisect-%D9%86%D9%82%D9%84-%D8%A7%D9%84%D8%A7%D8%B5%D9%84%D8%A7%D8%AD-%D9%88%D8%A7%D9%8A%D8%AC%D8%A7%D8%AF-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7/)[![](https://arabroot.io/content/images/2026/11/code-review-basics-cover-cover.webp)دليلمراجعة الكود Code Review: كيف تراجع Pull Request بفائدةكيف تفتح طلب دمج يسهل على زميلك مراجعته، وكيف تراجع طلب غيرك بتعليقات تحسن الكود دون أن تتحول إلى موافقة شكلية أو جدال، مع حماية الفرع main في Gitea.](https://arabroot.io/articles/%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D9%83%D9%88%D8%AF-code-review-%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-pull-request-%D8%A8%D9%81%D8%A7%D8%A6%D8%AF%D8%A9/)

إذا دمجت شيئاً ثم ندمت عليه، أو نفذت `reset --hard` وظننت أن عملك ضاع، فاقرأ [التراجع عن الأخطاء في Git](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/). وإذا جاءك طلب عاجل وأنت في منتصف ميزة فاقرأ [التبديل بين المهام في Git](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%A8%D8%AF%D9%8A%D9%84-%D8%A8%D9%8A%D9%86-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%81%D9%8A-git-stash-%D8%A7%D9%85-worktree/)، وإذا احتجت أن تنقل إصلاحاً واحداً إلى فرع إصدار دون بقية main فاقرأ [Cherry-pick مع git bisect](https://arabroot.io/articles/cherry-pick-%D9%85%D8%B9-git-bisect-%D9%86%D9%82%D9%84-%D8%A7%D9%84%D8%A7%D8%B5%D9%84%D8%A7%D8%AD-%D9%88%D8%A7%D9%8A%D8%AC%D8%A7%D8%AF-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7/). والصورة الكاملة لكل هذه المواضيع، مع استراتيجيات التفرع، في [Git في العمل اليومي](https://arabroot.io/articles/git-merge-%D9%88-rebase-%D9%88-cherry-pick/).

## الخلاصة 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 في العمل اليومي بعد تقسيمه إلى أربعة مقالات.