بعد أن تتعلم أن تنشئ Commit وفرعاً Branch وتدفع إلى السيرفر، يبدأ العمل الحقيقي مع الفريق، فتجد نفسك أمام أسئلة لا يجيب عنها الدليل الأول: زميلك دفع قبلك فرفض السيرفر الدفع، وفرعك تأخر عن main أسبوعاً، ومنصة Gitea تسألك عند الدمج هل تريد Merge أم Rebase أم Squash، والعميل يريد إصلاحاً واحداً في الإصدار الذي يعمل عنده الآن دون الميزات Features التي لم تكتمل، وأحدهم نفذ git reset --hard فاختفى عمل يوم كامل، وآخر حذف ملف .env بعد أن دفعه وظن أن المشكلة انتهت. وكل هذه المواقف لها أوامر في Git صممت لها بالتحديد، ولكل أمر قاعدة أمان إذا تجاوزتها خسرت عملك أو عمل زملائك.
وكان هذا المقال في نسخته الأولى يشرح كل هذه الأوامر في صفحة واحدة، فأصبح طويلاً على من يبدأ، لذلك قسمناه إلى أربعة مقالات للمبتدئين، كل مقال يأخذ موقفاً واحداً ويمشي فيه خطوة بخطوة على مستودع حقيقي في Container، مع مخرجات حقيقية ورسوم وتجربة «ماذا لو». وأصبح هذا المقال خريطة: يقول لك أين تجد كل موضوع، ويبقي هنا ما يخص الفريق كله، أي استراتيجيات التفرع Branching وطلبات الدمج وحماية الفروع. وإذا كنت لم تقرأ إدارة النسخ مع Git للمبتدئين بعد، فابدأ به. وسوف نناقش في هذا المقال ما يلي:
- كيف تختار المقال الذي تحتاجه من الموقف الذي أنت فيه.
- المقال الأول: Merge وRebase وSquash على المستودع نفسه، والتعارضات، والدفع بالقوة الآمن.
- المقال الثاني: التراجع بالأوامر revert وreset وrestore، وشبكة الأمان reflog.
- المقال الثالث: التبديل بين المهام بالأمرين stash وworktree.
- المقال الرابع: نقل إصلاح إلى فرع الإصدار بالأمر cherry-pick، والوسوم، والبحث عن الخطأ بالأمر bisect.
- استراتيجيات التفرع Git Flow وGitHub Flow وTrunk-Based، وطلبات الدمج وحماية الفروع، ثم أخطاء الفرق الشائعة وجدول الموقف والمقال.
كيف تستخدم هذه الخريطة؟ How to Use This Map
لا تحتاج أن تقرأ المقالات الأربعة بالترتيب، فكل واحد منها يبدأ بمختبره الخاص ولا يفترض أنك قرأت غيره، وإنما ابدأ من الموقف الذي أنت فيه الآن:
| الموقف | اقرأ |
|---|---|
| المنصة تسألك Merge أم Rebase أم Squash، أو ظهر لك تعارض | Merge أم Rebase أم Squash؟ |
| أخطأت وتريد أن تتراجع، أو اختفى عملك | التراجع عن الأخطاء في Git |
| جاءك طلب عاجل وأنت في منتصف ميزة | التبديل بين المهام في Git |
| العميل يحتاج إصلاحاً في إصداره، أو لا تعرف أي Commit أدخل الخطأ | Cherry-pick مع git bisect |
| الفريق يختلف على طريقة العمل بالفروع | استراتيجيات التفرع في هذا المقال |
والمقالات الأربعة كلها منفذة على git 2.54.0 في Container من Alpine، وكل مخرج فيها هو ما طبعه Git فعلاً، فتستطيع أن تكرر كل خطوة على جهازك دون أن تخاف على مشروع حقيقي.
وإذا وصلت إلى هذه الصفحة من رابط قديم إلى قسم معين، فكل قسم من النسخة الأولى ما زال هنا باسمه، ويحيلك في سطر أو سطرين إلى مكانه الجديد، مثل التعارضات، والدفع بالقوة الآمن، والتراجع، والبحث بالأمر git bisect.
المقال الأول: الدمج Merge أم Rebase أم Squash؟
هذا المقال يأخذ فرع ميزة واحداً ويدخله إلى main بالطرق الثلاث على النسخة نفسها، حتى ترى الفرق في شكل التاريخ وفي أرقام ال Commits. وهذه أقسامه مع رابط كل قسم:
الدمج السريع Fast-forward
عندما لا يتحرك main أثناء عملك على الفرع، فإن الدمج يحرك المؤشر فقط ولا ينشئ أي Commit، والتفاصيل في قسم الدمج السريع.
الدمج الثلاثي Three-way Merge
عندما يتقدم الفرعان، يقارن Git ثلاث نسخ وينشئ Merge Commit له أبوان، وفي المقال نطبعه بالأمر git cat-file حتى ترى السطرين parent بعينك، والخوارزمية الافتراضية هي ort.
الخيار --no-ff أو --ff-only
الأول يجبر Git على Merge Commit ليبقى أثر الميزة، كما يفعل زر Create a merge commit، والثاني يرفض أي دمج ليس سريعاً، وهو مفيد عند تحديث فرعك المحلي.
إعادة التأسيس Rebase
تنسخ Commits فرعك فوق آخر main بأرقام جديدة، فيصبح التاريخ خطاً واحداً، وفي المقال نرى في reflog أين ذهبت ال Commits القديمة، والتفاصيل في توثيق git rebase وقسم Rebase.
القاعدة الذهبية Golden Rule
لا تعد تأسيس Commits سحبها غيرك، كما يقول كتاب Pro Git. وفي المقال جربنا ما يحدث إذا تجاوزتها: أعاد شخص تأسيس فرع مشترك ودفعه بالقوة، فظهر عند زميلته تعارض في كود لم يغيره أحد، وظهرت ال Commits نفسها مرتين برقمين مختلفين.
السحب مع git pull --rebase
عندما يرفض السيرفر الدفع لأن زميلك دفع قبلك، كما رأينا في دليل المبتدئين، فإن git pull --rebase يضع Commitك المحلي فوق عمله دون Merge Commit، وإعداد pull.rebase في توثيق git pull.
إعادة التأسيس التفاعلية Interactive Rebase
الأمر git rebase -i يرتب Commits فرعك قبل المراجعة بالأوامر pick وfixup وsquash وdrop وreword، وفي المقال خمسة Commits تصبح اثنين.
git commit --fixup=<hash>، ثم نفذ لاحقاً git rebase -i --autosquash main، فيضع Git كل Commit من نوع fixup تحت ال Commit الذي يصلحه تلقائياً.Merge أم Rebase؟ المقارنة Comparison
الطريقتان تصلان إلى المحتوى نفسه، والفرق في شكل التاريخ وفي الأمان على الفروع المشتركة، وفي المقال جدول يضعهما مع Squash جنباً إلى جنب، مع السياسات التي تتبعها الفرق، وقيم الخيار DEFAULT_MERGE_STYLE في إعدادات Gitea.
الدمج مع الضغط Squash Merge
كل طلب دمج يصبح Commit واحداً في main، وهو أبسط سياسة لفريق صغير، وفي قسم Squash نرى لماذا يرفض Git بعده حذف الفرع بالخيار -d.
التعارضات Conflicts
بدأنا التعارض في دليل المبتدئين، وفي المقال الأول نحل التعارض نفسه مرة بالدمج ومرة بإعادة التأسيس، ونرى لماذا ينعكس معنى HEAD بينهما، ونفعل zdiff3 لنرى الأصل المشترك.
الأمر rerere
يحفظ Git حلك لكل تعارض ويطبقه تلقائياً إذا ظهر التعارض نفسه مرة أخرى، وجربناه في المقال، والتفاصيل في توثيق git rerere.
أدوات حل التعارض Merge Tools
إذا كنت تفضل أداة رسومية تعرض النسخ الثلاث جنباً إلى جنب، فالأمر git mergetool يفتح الأداة التي تختارها لكل ملف فيه تعارض، وأغلب المحررات الحديثة تعرض التعارض بأزرار لقبول أي طرف، والفكرة في الحالتين هي نفسها الكتل التي شرحناها في المقال.
كيف تقلل التعارضات؟ Fewer Conflicts
طلبات صغيرة تدمج في يوم أو يومين، وسحب main إلى فرعك بانتظام، وأداة تنسيق تعمل تلقائياً، ولا تخلط إعادة تنسيق ملف كامل مع تغيير سلوك في طلب واحد.
الدفع بالقوة الآمن Force with Lease
الخيار --force-with-lease لا يكتب فوق فرعك على السيرفر إلا إذا كان كما رأيته آخر مرة، ولكن في المقال رأينا كيف يحذف عمل زميل إذا نفذت git fetch قبله، لذلك ننصح بالصيغة --force-with-lease --force-if-includes كما يحذر توثيق git push.
المقال الثاني: التراجع revert أم reset أم restore؟
هذا المقال يبدأ بسؤال واحد قبل أي أمر: أين وصل الخطأ؟ إلى الملفات فقط، أم إلى منطقة التجهيز، أم إلى Commit محلي، أم إلى السيرفر؟ ولكل مكان أمره، وقد بدأنا الفكرة في قسم restore وقسم revert في دليل المبتدئين.
الأمر revert
يضيف Commit يعكس الخطأ دون أن يغير التاريخ، فهو الطريقة الوحيدة الآمنة على فرع مشترك، وفي المقال نعكس به Merge Commit كاملاً بالخيار -m 1.
الأمر restore
للتعديلات التي لم تدخل Commit، ومعه --staged لإخراج ملف من التجهيز دون أن تمسحه، و--source لأخذ ملف من Commit قديم.
الأمر reset
يرجع الفرع إلى الخلف، والفرق بين soft وmixed وhard هو مكان التغييرات بعده، وفي المقال ترى مخرج git status بعد كل نوع.
git reset لإزالة Commits دفعتها إلى فرع مشترك، فلن يقبل السيرفر الدفع إلا بالقوة، وعندها تبقى ال Commits عند زملائك ويعيدها أول من يدفع منهم. والطريقة الصحيحة هي git revert. وقبل أي reset --hard نفذ git status، واحفظ ما لم تلتزم به بالأمر git stash.شبكة الأمان reflog
يسجل Git كل حركة لمؤشر HEAD، فتسترجع منه Commits ظننت أنها ضاعت بعد reset أو rebase، ولكنه محلي وله مدة، والقيم الافتراضية في توثيق git gc. وفي المقال نسترجع أيضاً فرعاً محذوفاً، وملفاً جهزته ثم مسحته بالأمر git fsck، ونرى الخطأ الوحيد الذي لا ينقذه شيء.
المقال الثالث: التبديل بين المهام Stash أم Worktree؟
طلب عاجل وأنت في منتصف ميزة: هذا المقال يشرح الحفظ المؤقت git stash بالتفصيل، وماذا يحفظ دون الخيار -u وماذا يترك، ولماذا يرجع pop التعديل المجهز غير مجهز، وماذا يحدث عند التعارض، وكيف تسترجع حفظاً حذفته. ثم يشرح الأداة التي لا يعرفها كثيرون git worktree، التي تعطيك مجلد عمل ثانياً للمستودع نفسه، فتعمل على الإصلاح هناك وعملك هنا لم يتحرك، ويجربها في ثلاث حالات: إصلاح عاجل، ومراجعة طلب دمج، وتشغيل إصدارين معاً.
المقال الرابع: الانتقاء Cherry-pick مع git bisect
العميل على الإصدار 1.0.0 ويحتاج إصلاحاً واحداً من main دون الميزات غير المكتملة: هذا المقال ينشئ فرع إصدار من الوسم، وينقل الإصلاح بالأمر git cherry-pick -x، ويضع وسم v1.0.1 ويدفعه. ويوصي Trunk-Based Development بأن يصلح الخطأ على الفرع الرئيسي أولاً ثم ينتقى إلى فرع الإصدار.
عندما يتعارض الانتقاء Cherry-pick Conflict
في المقال ثلاث حالات حقيقية: انتقاء فارغ لأن الإصلاح موجود من قبل، وتعارض لأن الإصلاح يعتمد على Commit لم تنقله، ورفض Merge Commit دون الخيار -m، ومعها الأمر git cherry الذي يخبرك بما نقلته.
الوسوم Tags مع ترقيم الإصدارات SemVer
الوسم المشروح للإصدارات والخفيف للعلامات المؤقتة كما في توثيق git tag، وقد بدأناه في دليل المبتدئين، وgit push لا يدفعه إلا باسمه، والأرقام تتبع Semantic Versioning الذي شرحناه في الإصدارات SemVer مع سجل التغييرات، والبناء من الوسم يتم بخط CI مثل Gitea Actions.
من عطل البرنامج؟ البحث بالأمر git bisect
يجد git bisect أول Commit معطوب بالبحث الثنائي، ومع git bisect run يشغل الاختبار بنفسه. وفي المقال مشكلة حقيقية جعلته يتهم Commit بريئاً بسبب ملفات Python المترجمة القديمة، وكيف تكتب اختباراً لا يخدعك.
استراتيجيات التفرع Branching: Git Flow مع GitHub Flow مع Trunk-Based
الأوامر في المقالات الأربعة أدوات، والاستراتيجية هي الاتفاق في الفريق على متى تفتح الفروع وكم تعيش وكيف تصل إلى الإنتاج Production، والصورة التالية تقارن بين أشهر ثلاث استراتيجيات:

Git Flow: نموذج نشره Vincent Driessen في يناير 2010، فيه فرعان دائمان هما main للإنتاج وdevelop للتطوير، وفروع feature تخرج من develop وتعود إليه، وفروع release لتجهيز الإصدار، وفروع hotfix للإصلاحات العاجلة تدمج في main وdevelop معاً. وقد أضاف الكاتب نفسه في مارس 2020 ملاحظة في أعلى المقال يقول فيها إن هذا النموذج ليس الأنسب لفرق تطبيقات الويب التي تنشر باستمرار، وينصحها بنموذج أبسط مثل GitHub Flow، ويبقي Git Flow للبرامج التي تصدر بأرقام إصدارات صريحة أو تدعم أكثر من إصدار في الوقت نفسه.
GitHub Flow: فرع رئيسي واحد قابل للنشر دائماً، وكل تغيير في فرع قصير يفتح له طلب دمج، ويراجع وتنجح اختباراته، ثم يدمج ويحذف الفرع، كما في وصف GitHub. ولا توجد فروع develop أو release، والنشر يتم بعد الدمج.
Trunk-Based Development: كل المطورين يدمجون في فرع واحد يسمى trunk، ويقاومون إنشاء أي فرع آخر يعيش طويلاً، والفروع إن وجدت تعيش ساعات أو يوماً أو يومين للمراجعة وCI، والميزات غير المكتملة تدمج مخفية خلف Feature Flags، وعند الحاجة يقطع فرع إصدار من trunk، والإصلاحات تصل إليه بالانتقاء كما في المقال الرابع. وقد شرحنا هذه الطريقة بالتفصيل وكيف تنقل فريقك إليها من Git Flow في التطوير على الفرع الرئيسي Trunk-Based.
وأي واحدة تناسب فريقاً صغيراً؟ في أغلب الحالات GitHub Flow مع حماية main وفحوص CI إلزامية وSquash Merge، وهو في الواقع قريب جداً من Trunk-Based بفروع قصيرة، وإذا احتجت أن تدعم إصداراً قديماً عند عميل فأضف فرع إصدار عند الحاجة فقط. أما Git Flow فلا ننصح به لفريق صغير ينشر تطبيق ويب، لأن فرع develop الدائم يؤخر وصول كل تغيير إلى الإنتاج ويضاعف التعارضات. وأين يختبر فريق ضمان الجودة QA إذا لم يكن هناك فرع develop؟ وكيف تعطي كل طلب دمج بيئة معاينة Preview خاصة به؟ هذا هو موضوع البيئات ومعاينة الميزات وGitOps للفرق.
طلبات الدمج Pull Requests مع حماية الفروع Branch Protection
في الفرق لا يدفع أحد إلى main مباشرة، وإنما يعمل كل شخص على فرع ويفتح طلب دمج، ويسمى Pull Request في Gitea وGitHub وMerge Request في GitLab، والفكرة واحدة: الزملاء يرون الفروقات ويعلقون على الأسطر، وخط CI يشغل الاختبارات على الفرع، ثم يدمج الطلب بالطريقة التي يسمح بها المستودع. وإذا كنت تريد هذا على سيرفرك فقد شرحنا تثبيت Gitea.
ولكن الطلب وحده لا يمنع أحداً من أن يدفع إلى main مباشرة، أو أن يدمج طلباً فشلت اختباراته، ولذلك توفر المنصات حماية الفروع، وفي Gitea تجد في إعدادات المستودع قواعد الحماية: منع الدفع المباشر، ومنع الدفع بالقوة، وعدد الموافقات المطلوبة، وفحوص الحالة الإلزامية. وفي GitHub تمنع كل قاعدة حماية الدفع بالقوة وحذف الفرع افتراضياً. وقد جربنا هذه القواعد كلها على Gitea حقيقي، وكيف تكتب طلباً يسهل مراجعته وكيف تراجع طلب زميلك، في مراجعة الكود Code Review.
أخطاء الفرق الأكثر شيوعاً Common Mistakes
الدفع بالقوة إلى main Force Push
شخص أعاد تأسيس main عنده أو نفذ reset، ثم رفض السيرفر الدفع فأضاف --force، فاختفت من السيرفر Commits زملائه. والحل الوقائي هو حماية الفرع على السيرفر كما في القسم السابق، وإذا حدث فلا تقم بأي دفع آخر، وCommits الزملاء ما زالت في مستودعاتهم المحلية وفي reflog عند من دفع.
إعادة تأسيس فرع مشترك Shared Rebase
هي القاعدة الذهبية، والعلامة التي تبين أنها حدثت أن تظهر لك Commits مكررة بالرسالة نفسها وأرقام مختلفة بعد السحب.
التزام سر ثم «حذفه» Committed Secrets
حذف ملف .env في Commit جديد لا يحذفه من التاريخ، والأمر git show يطبع كلمة المرور Password من ال Commit السابق. لذلك ألغ السر فوراً وأصدر بديلاً، وهي الخطوة الأولى التي يوصي بها GitHub، ثم نظف التاريخ إذا لزم بأداة git filter-repo. والتجربة كاملة في التراجع عن الأخطاء في Git، وأين تضع الأسرار بدلاً من المستودع في قائمة تحقق المطور، وما لا يجب أن يدخل المستودع عموماً في دليل المبتدئين.
أخطاء أخرى تتكرر Other Mistakes
- reset --hard فوق تعديلات لم تلتزم بها: لا ينقذها reflog، فنفذ
git statusأولاً. - فرع يعيش أسابيع: كل يوم إضافي يزيد التعارضات يوم الدمج، فقسم العمل إلى طلبات صغيرة.
- Squash ثم الاستمرار على الفرع نفسه: افتح فرعاً جديداً من main بعد كل دمج.
- نسيان git bisect reset: تبقى على Commit قديم دون فرع.
- نقل وسم إصدار منشور: أصدر رقماً جديداً بدلاً من ذلك.
الموقف والأمر والمقال Cheat Sheet
| الموقف | الأمر | المقال |
|---|---|---|
| دمج فرع ميزة مع إبقاء أثره | git merge --no-ff feature | الأول |
| سحب عمل الزملاء فوق Commitsك المحلية | git pull --rebase | الأول |
| ترتيب Commitsك قبل طلب الدمج | git rebase -i main | الأول |
| طلب كامل في Commit واحد | git merge --squash feature | الأول |
| الدفع بعد إعادة تأسيس فرعك | git push --force-with-lease --force-if-includes | الأول |
| إعادة استخدام حلول التعارضات | git config --global rerere.enabled true | الأول |
| إلغاء تعديل لم تلتزم به | git restore <file> | الثاني |
| التراجع عن Commit دفعته | git revert <hash> | الثاني |
| إلغاء آخر Commit محلي مع إبقاء التغييرات | git reset --soft HEAD~1 | الثاني |
| استرجاع Commit بعد reset | git reflog ثم git branch rescue HEAD@{1} | الثاني |
| حفظ عمل غير مكتمل مؤقتاً | git stash push -u -m "..." | الثالث |
| مجلد عمل ثان لإصلاح عاجل | git worktree add -b hotfix/x ../hotfix main | الثالث |
| نسخ إصلاح إلى فرع إصدار | git cherry-pick -x <hash> | الرابع |
| وسم إصدار ودفعه | git tag -a v1.2.0 -m "..." ثم git push origin v1.2.0 | الرابع |
| البحث عن ال Commit الذي أفشل اختباراً | git bisect run <test> | الرابع |
تدريب عملي Practice
- اختر من المقالات الأربعة الموقف الذي تخافه أكثر، ونفذ مختبره كاملاً في Container قبل أن تحتاجه في مشروع حقيقي.
- على Gitea عندك، فعل حماية main بمنع الدفع المباشر والدفع بالقوة واشترط نجاح مهمة CI، ثم حاول أن تدفع إلى main مباشرة وأن تدفع بالقوة، واقرأ رسالة الرفض.
- اكتب في ملف README في مستودع فريقك سياسة الفريق في سطرين: طريقة الدمج المسموحة، ومتى يفتح فرع إصدار.
الخلاصة Summary
وصلنا لنهاية الخريطة، وأهم ما فيها:
- الدمج يضيف ولا يغير، فهو آمن على كل الفروع، وإعادة التأسيس تنسخ Commits بأرقام جديدة فاستخدمها لعملك المحلي فقط، وSquash يعطي main Commit واحداً لكل طلب.
- revert للفروع المشتركة، وreset لعملك المحلي، وreflog يحفظ الطريق إلى أي Commit لمدة محدودة وعلى جهازك فقط.
- stash لمقاطعة قصيرة، وworktree لمهمة طويلة أو لتشغيل نسختين معاً.
- الانتقاء ينقل إصلاحاً إلى فرع إصدار بعد أن يدخل main، والوسم يدفع باسمه، وbisect يجد أول Commit معطوب بخطوات قليلة إذا كان اختبارك يرى الكود الحالي فعلاً.
- لفريق صغير: فرع رئيسي واحد وطلبات دمج صغيرة وSquash، وحماية main على السيرفر، وفروع إصدار عند الحاجة فقط.
دليلMerge أم Rebase أم Squash؟ دمج الفروع في Git خطوة بخطوةثلاث طرق لإدخال عمل فرعك إلى main، نجربها على المستودع نفسه حتى ترى بعينك ماذا تفعل كل واحدة بالتاريخ، ومتى تختارها، وكيف تحل التعارض في كل منها.
دليلالتراجع عن الأخطاء في Git: revert أم reset أم restore؟لكل خطأ في Git أمر تراجع يناسب المكان الذي وصل إليه، وهنا تتعلم أن تختاره بسؤال واحد، وأن تسترجع عملاً ظننت أنه ضاع.
دليلالتبديل بين المهام في Git: Stash أم Worktree؟عندما يأتيك طلب عاجل وأنت في منتصف ميزة، تحفظ عملك جانباً بالأمر stash أو تفتح له مجلداً ثانياً بالأمر worktree، وهنا تتعلم الاثنين خطوة بخطوة ومتى تختار كل واحد.
دليلCherry-pick مع git bisect: نقل الإصلاح وإيجاد الخطأكيف تنقل إصلاحاً واحداً إلى الإصدار الذي يعمل عند العميل دون بقية التغييرات وتضع له وسماً، وكيف تجد الـ Commit الذي أدخل الخطأ بين عشرات الـ Commits في دقائق.
دليلTrunk-Based Development: فروع قصيرة ودمج يوميلماذا تنفجر الفروع الطويلة يوم الإصدار، وكيف يدمج الفريق عمله في main كل يوم بأمان مع CI وFeature Flags.
دليلمراجعة الكود Code Review: كيف تراجع Pull Request بفائدةكيف تفتح طلب دمج يسهل على زميلك مراجعته، وكيف تراجع طلب غيرك بتعليقات تحسن الكود دون أن تتحول إلى موافقة شكلية أو جدال، مع حماية الفرع main في Gitea.سجل التحديثات Changelog
- أكتوبر 2026: كتابة المقال، وتنفيذ كل الأمثلة على Git 2.48.1 في مستودعات محلية، مع سيرفر Git محلي في مستودع Bare لأمثلة الدفع والسحب.
- نوفمبر 2026: تقسيم المقال إلى أربعة مقالات للمبتدئين، هي Merge أم Rebase أم Squash، والتراجع عن الأخطاء في Git، والتبديل بين المهام في Git مع إضافة Worktree، وCherry-pick مع git bisect، وكلها منفذة من جديد على git 2.54.0. وأصبح هذا المقال خريطة لها، وبقيت فيه استراتيجيات التفرع وطلبات الدمج وحماية الفروع، وعدلنا عنوانه وعناوين أقسامه.