الفروع في Git: branch و switch و merge

موقعك يعمل جيداً على الفرع main، وتريد إضافة صفحة جديدة. لكن ماذا لو كسرت شيئاً أثناء العمل؟ أو احتجت إصلاح خطأ عاجل في منتصف عملك على الصفحة؟ الحل: الفروع (Branches). كل فرع خط عمل مستقل، تجرّب فيه بحرية، ثم تدمجه في الخط الأساسي عندما يجهز. وهذه أكثر ميزة يحبها المبرمجون في Git.

ما هو الفرع؟

تخيّل أنك تكتب رواية. النسخة الأساسية في دفتر، وتريد تجربة نهاية مختلفة. بدلاً من الكتابة فوق الأصل، تصوّر نسخة وتجرب عليها. إذا أعجبتك النهاية الجديدة، تنقلها للأصل. وإذا لم تعجبك، ترمي النسخة دون أن يتأثر الأصل.

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

عرض الفروع وإنشاؤها

نكمل على مستودع my-site من الدرس السابق:

git branch

الناتج

* main

النجمة * تشير للفرع الحالي. لننشئ فرعاً لصفحة «اتصل بنا»:

git branch contact-page
git branch

الناتج

  contact-page
* main

الفرع أُنشئ، لكننا ما زلنا على main.

التنقل بين الفروع: git switch

git switch contact-page

الناتج

Switched to branch 'contact-page'

الآن ننشئ contact.html ونحفظه:

git add contact.html
git commit -m "إضافة صفحة اتصل بنا"

ثم نعود لـ main:

git switch main
ls

الناتج

README.md
index.html

أين ذهب contact.html؟! إنه موجود بأمان في فرع contact-page. عند التنقل بين الفروع، يغيّر Git الملفات في مجلدك لتطابق الفرع الذي انتقلت إليه. هذا هو الاستقلال الحقيقي بين الفروع.

اختصار مفيد: git switch -c dark-mode تنشئ الفرع وتنتقل إليه في خطوة واحدة.

git checkout

ستجد في شروحات قديمة الأمر git checkout للتنقل بين الفروع. ما زال يعمل، لكنه يقوم بمهام كثيرة مختلفة فيربك المبتدئين، لذلك أضاف Git الأمر الأوضح git switch المخصص للفروع فقط.

الدمج: git merge

صفحة «اتصل بنا» جاهزة، فلندمجها في main. انتقل أولاً للفرع الذي تريد الدمج فيه، ثم ادمج:

git switch main
git merge contact-page

الناتج

Updating 1af0b70..2d680ed
Fast-forward
 contact.html | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 contact.html

Fast-forward (تقديم سريع): بما أن main لم يتغير منذ التفرّع، اكتفى Git بتحريك مؤشر main للأمام ليشمل النقاط الجديدة. أبسط أنواع الدمج.

لكن ماذا لو تغيّر الفرعان معاً؟ في فرع dark-mode أضفنا ملف style.css، وفي نفس الوقت تقدّم main بدمج صفحة الاتصل. الآن:

git merge dark-mode -m "دمج الوضع الليلي"
git log --oneline --graph

الناتج

*   beb7ec5 دمج الوضع الليلي
|\
| * a9d945f إضافة الوضع الليلي
* | 2d680ed إضافة صفحة اتصل بنا
|/
* 1af0b70 تجاهل الملفات السرية
* 4abe678 إضافة فقرة ترحيب
* c8ef559 إضافة الصفحة الرئيسية وملف README

هنا أنشأ Git نقطة دمج (Merge Commit) جديدة تجمع الخطين. و --graph يرسم التاريخ: ترى الخطين يفترقان ثم يلتقيان. جمال Git: كل فرع عدّل ملفات مختلفة، فدمجهما آلياً دون أي مشكلة.

حذف الفرع بعد الدمج

git branch -d contact-page

الناتج

Deleted branch contact-page (was 2d680ed).

الفرع أدى مهمته، وتعديلاته أصبحت في main، فلا داعي لبقائه. والخيار -d آمن: يرفض حذف فرع لم يُدمج بعد.

التعارض (Conflict)

ماذا لو عدّل فرعان نفس السطر في نفس الملف بطريقتين مختلفتين؟ في فرع title-a غيّرنا العنوان إلى «موقعي الجديد»، وفي main غيّرناه إلى «موقع سارة»:

git merge title-a

الناتج

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

Git لا يستطيع أن يقرر بدلاً منك أي عنوان هو الصحيح! فيضع العلامات في الملف ويطلب منك القرار:

index.html

<<<<<<< HEAD
<h1>موقع سارة</h1>
=======
<h1>موقعي الجديد</h1>
>>>>>>> title-a
<p>أهلاً بك</p>

• بين <<<<<<< HEAD و =======: نسخة الفرع الحالي (main).
• بين ======= و >>>>>>> title-a: نسخة الفرع القادم.

لحل التعارض:

1. افتح الملف، واحذف العلامات الثلاث، واترك النص الصحيح. يمكنك اختيار إحدى النسختين، أو كتابة نسخة جديدة تجمع الاثنتين، مثل «موقع سارة الجديد».
2. احفظ الملف، ثم git add index.html.
3. أنهِ الدمج بـ git commit -m "حل التعارض في العنوان".

تخيّل التعارض مثل محررَين عدّلا نفس الجملة في كتاب بطريقتين مختلفتين: لا بد أن يقرر رئيس التحرير الصيغة النهائية. و VS Code يعرض التعارض بألوان وأزرار مثل «Accept Current» و«Accept Incoming» تسهّل عليك الاختيار.

التعارض ليس كارثة

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

جرّب بنفسك

1. في مستودعك، أنشئ فرعاً اسمه about-page وانتقل إليه بأمر واحد.
2. أضف صفحة about.html واحفظها، ثم عد إلى main ولاحظ اختفاءها.
3. ادمج الفرع في main، واحذفه.
4. اصنع تعارضاً عن قصد: أنشئ فرعين يعدّلان نفس السطر بطريقتين، وادمجهما، ثم حل التعارض.
5. اعرض التاريخ بـ git log --oneline --graph.

أخطاء شائعة

• الدمج وأنت على الفرع الخطأ: git merge تدمج في الفرع الحالي. انتقل لـ main أولاً.
• نسيان العلامات في الملف بعد حل التعارض: تبقى <<<<<<< في الكود فيتعطل. ابحث عنها قبل الحفظ.
• التنقل بين الفروع مع تعديلات غير محفوظة: قد يرفض Git أو تنتقل التعديلات معك. احفظها بـ commit قبل التنقل.

اختبر نفسك

سؤال

أي أمر ينشئ فرعاً جديداً اسمه feature وينتقل إليه مباشرة؟

git merge featuregit branch featuregit switch -c feature

سؤال

متى يحدث التعارض (Conflict) عند الدمج؟

عند دمج أي فرعينعندما يعدّل الفرعان نفس الجزء من نفس الملف بطريقتين مختلفتينعندما يكون اسم الفرع طويلاً

الخلاصة

• الفرع خط عمل مستقل وخفيف، تجرّب فيه دون التأثير على main.
• git branch يعرض وينشئ، و git switch ينقلك، و git switch -c ينشئ وينقل.
• git merge يدمج فرعاً في الفرع الحالي: تقديم سريع، أو نقطة دمج جديدة.
• git branch -d يحذف الفرع المدمج بأمان.
• التعارض: Git يضع العلامات، وأنت تختار النتيجة، ثم add و commit.