الفروع والسجل

الفرع خط تطوير مستقل. يسمح لك بالعمل على ميزة جديدة دون المساس بالإصدار الرئيسي (main)، الذي يبقى مستقراً.

تشبيه: مستند مشترك. بدل تحرير النسخة الرسمية مباشرة (خطر كسر الكل)، تعمل على نسخة عمل (الفرع). عندما ترضى، تدمج تغييراتك في الأصل.

لماذا هو أساسي:

• العزل: عمل تجريبي لا يكسر الإصدار المستقر أبداً.
• التعاون: كل شخص يعمل على فرعه، دون إعاقة الآخرين.
• التنظيم: فرع = ميزة أو تصحيح.

# سرد الفروع (الحالي معلَّم بـ *)
git branch

# إنشاء فرع
git branch feature-connexion

# التبديل إلى فرع
git switch feature-connexion

# الإنشاء والتبديل في أمر واحد (موصى به)
git switch -c feature-connexion

git switch الأمر الحديث المخصَّص للفروع. git checkout ما زال يعمل لكنه يفعل أشياء كثيرة دفعة واحدة — فضّل switch للفروع.

تمرين مصغّر — اكتب الأمر الذي ينشئ الفرع feature-login وينتقل إليه في عملية واحدة.

git switch -c feature-login

الدمج (merge) هو إدماج تغييرات فرع في فرع آخر — عادة إعادة ميزتك المنتهية إلى main.

# 1. الانتقال إلى الفرع الذي سيستقبل التغييرات
git switch main

# 2. دمج فرع الميزة فيه
git merge feature-connexion

# بعد دمج ناجح، يمكن حذف الفرع
git branch -d feature-connexion

قاعدة بسيطة: نقف على فرع الوجهة (main)، ثم ندمج الفرع المصدر فيه. «أنا على main، أستوعب feature».

تمرين مصغّر — أنت على feature-login والعمل منتهٍ. اكتب الأمرين لدمج هذا الفرع في main.

git switch main
git merge feature-login

يحدث تعارض عندما يعدّل فرعان السطر نفسه في الملف نفسه. Git لا يستطيع الاختيار عنك: يطلب منك الحسم.

يدرج Git علامات في الملف المتعارض:

<<<<<<< HEAD
نص الفرع الحالي (main)
=======
نص الفرع المدموج (feature)
>>>>>>> feature-connexion

للحل:

1. افتح الملف، اختر المحتوى الصحيح (أو اجمع الاثنين).
2. احذف العلامات <<<<<<< و ======= و >>>>>>>.
3. git add fichier ثم git commit لإنهاء الدمج.

التعارض ليس خطأ جسيماً: Git يحميك برفض التخمين. ابق هادئاً، اقرأ النسختين، أبقِ الصحيحة.

تمرين مصغّر — اذكر العلامات الثلاث التي يدرجها Git في ملف متعارض ويجب حذفها بعد الحل.

# السجل الكامل
git log

# نسخة مختصرة (سطر لكل إيداع)
git log --oneline

# مع رسم الفروع والدمج
git log --oneline --graph --all

# رؤية تعديلات إيداع
git show <hash>

# رؤية من عدّل كل سطر في ملف
git blame fichier.txt

سجل Git آلة زمن. مستخدَماً جيداً (برسائل إيداع جيدة)، يسمح بفهم لماذا الشفرة في حالتها الحالية.

تمرين مصغّر — اكتب الأمر الذي يعرض السجل بشكل مختصر، مع رسم الفروع وكل الفروع.

git log --oneline --graph --all

السؤال 1: لماذا يُستخدم الفرع؟

a) لحذف السجل

b) للتطوير بمعزل دون المساس بالإصدار الرئيسي

c) للاتصال بـ GitHub

d) لتجميع الشفرة

السؤال 2: أي أمر ينشئ فرعاً وينتقل إليه؟

a) git branch nom

b) git switch -c nom

c) git merge nom

d) git log nom

السؤال 3: لدمج feature في main، يجب أولاً…

a) الوقوف على feature ثم git merge main

b) الوقوف على main ثم git merge feature

c) حذف main

d) تنفيذ git init

السؤال 4: متى يحدث تعارض دمج؟

a) عندما يعدّل فرعان السطر نفسه في الملف نفسه

b) عند كل دمج، دائماً

c) عند إنشاء فرع

d) عند تثبيت Git

السؤال 5: أي أمر يعرض السجل مع رسم الفروع؟

a) git status

b) git log --oneline --graph --all

c) git branch -d

d) git add .

المطلوب

على مستودع موجود، أنشئ فرعاً، أودع فيه، ثم ادمجه في main واستشر الرسم.

التصحيح — سلسلة الأوامر المتوقعة

# 1. الانطلاق من main محدَّث
git switch main

# 2. إنشاء فرع ميزة والانتقال إليه
git switch -c feature-titre

# 3. العمل والإيداع على الفرع
echo "## قسم جديد" >> README.md
git add README.md
git commit -m "يضيف قسماً جديداً إلى README"

# 4. العودة إلى main والدمج
git switch main
git merge feature-titre

# 5. تنظيف الفرع المدموج
git branch -d feature-titre

# 6. تصوير السجل
git log --oneline --graph --all

النتيجة المتوقعة: يظهر إيداع الفرع في سجل main، و git branch لم يعد يسرد feature-titre.

هذه الدورة — إنشاء فرع، عمل، دمج، حذف — سير العمل اليومي للمطوّر. ستكررها مئات المرات.

النقاط التي يجب تذكّرها

1. فرع = خط تطوير معزول؛ main يبقى مستقراً.
2. git switch -c nom ينشئ فرعاً وينتقل إليه.
3. الدمج: الوقوف على الوجهة (main)، ثم git merge source.
4. التعارض يحدث على الأسطر نفسها المعدَّلة من الطرفين؛ يُحَل يدوياً.
5. git log --oneline --graph --all يصوّر القصة والفروع.

ما يلي

الدرس 08 — المستودع البعيد: مشاركة عملك على الخط والتعاون عبر خادم Git (GitHub).