Pull Request وحل التعارضات

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

سير العمل بالفروع و Pull Request

git switch -c contact-form
# ... عمل ولقطات ...
git push -u origin contact-form

بعد رفع الفرع يعرض عليك GitHub زر Compare & pull request. اضغطه واكتب:

  • العنوان: ماذا يضيف هذا الطلب، مثل «Add contact form with validation».
  • الوصف: ماذا فعلت، وكيف تختبره، وصورة إن كان التغيير مرئيًا.

بعد المراجعة يضغط أحدكم Merge pull request، ثم يحدّث كل واحد نسخته:

git switch main
git pull

مراجعة الكود والتعليقات

في تبويب Files changed يرى المراجع كل سطر تغيّر، ويستطيع أن يعلّق على سطر بعينه، أو يطلب تعديلات، أو يوافق. إذا طُلبت منك تعديلات، فلا تفتح طلبًا جديدًا: عدّل في نفس الفرع وارفع، فيتحدّث الطلب تلقائيًا.

حتى لو كنت تعمل وحدك، جرّب أن تراجع طلباتك بنفسك قبل الدمج. ستكتشف أخطاء لم ترها وأنت تكتب.

ما هو التعارض ولماذا يحدث

التعارض (Conflict) يحدث عندما يغيّر فرعان نفس الأسطر من نفس الملف بطريقتين مختلفتين. Git لا يعرف أي التغييرين تريد، فيتوقف ويسألك.

ستجد في الملف علامات مثل هذه:

<<<<<<< HEAD
<h1>مرحبًا بكم في متجر النور</h1>
=======
<h1>أهلًا بكم في متجرنا</h1>
>>>>>>> contact-form

الجزء الأعلى ما في فرعك الحالي، والأسفل ما في الفرع الذي تدمجه.

حل تعارض خطوة بخطوة

  1. افتح الملف. في VS Code تظهر أزرار فوق التعارض: Accept Current أو Accept Incoming أو Accept Both.
  2. اختر النسخة الصحيحة، أو اكتب نسخة تجمع الاثنين.
  3. احذف كل العلامات <<<<<<< و ======= و >>>>>>>.
  4. احفظ الملف، ثم:
git add index.html
git commit

التعارض ليس خطأ ولا كارثة، بل سؤال من Git. لتقليله: اجعل الفروع قصيرة العمر، واسحب آخر التحديثات من main بانتظام.

مهمتك

اصنع تعارضًا عمدًا: أنشئ فرعًا وغيّر فيه عنوان الصفحة واحفظ لقطة، ثم ارجع إلى main وغيّر نفس العنوان بنص آخر واحفظ لقطة. ادمج الفرع، وحل التعارض، ثم كرّر التجربة عبر Pull Request على GitHub.