نزاعات الدمج: لا داعي للذعر — افهمها وحُلّها

أنواع تعارضات الدمج الثلاثة

• تعارضات المحتوى: تغييرات في الأسطر نفسها
• تعارضات إعادة التسمية: تغيّر الملف وأُعيدت تسميته
• تعارضات الحذف: حُذف الملف في فرع، وتغيّر في فرع آخر
• إعادة التسمية هي الأكثر خداعاً بالنسبة إلى Git
• افحصوا سجل الملف عند ظهور تعارضات غير مألوفة

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

تشريح تعارض معقّد

• علامات <<<<<<< تُظهر تغييراتكم
• ======= تفصل بين نسختكم ونسخة الآخرين
• >>>>>>> تشير إلى نهاية كتلة التعارض
• git status سيُظهر كل الملفات المتأثرة بالمشكلة
• git diff يعطي مقارنة تفصيلية للتغييرات

لنفترض أنكم تدمجون فرع feature في main وظهرت رسالة تعارض. افتحوا الملفات المتأثرة؛ ستلاحظون علامات خاصة. كل ما يقع بين <<<<<<< HEAD و ======= هو تغييراتكم. وما يقع بين ======= و >>>>>>> feature هو التغييرات القادمة من الفرع الذي تدمجونه. استخدموا git status لمعرفة كل الملفات التي فيها تعارضات، واستخدموا git diff لاستعراض الفروقات بتفصيل أكبر. وتذكروا: العلامات ليست خطأً بحد ذاتها، بل إرشاد يوضح أين يجب اتخاذ القرار.

#!/bin/bash
# conflict_analysis.sh

echo "ننشئ مستودعاً اختبارياً"
mkdir conflict-demo && cd conflict-demo
git init

echo "ننشئ ملفاً وننشئ الالتزام الأول في main"
echo 'Line 1' > file.txt
echo 'Line 2' >> file.txt
git add . && git commit -m 'الالتزام الأول'

echo "ننشئ فرع feature ونعدّل السطر الأول"
git checkout -b feature
sed -i 's/Line 1/Line 1 modified in feature/' file.txt
git commit -am 'تعديل السطر 1 في feature'

echo "نعود إلى main ونعدّل السطر نفسه"
git checkout main
sed -i 's/Line 1/Line 1 modified in main/' file.txt
git commit -am 'تعديل السطر 1 في main'

echo "نحاول دمج الفرعين"
git merge feature || echo 'تعارض!'

echo "\nنراجع الحالة:"
git status --short

echo "\nنعرض الملف المتعارض:"
cat file.txt

استراتيجيات حل التعارضات

• التعديل اليدوي: إزالة العلامات والاحتفاظ باللازم
• أدوات الواجهة الرسومية: مثل meld و kdiff3 للمقارنة المرئية
• --ours/--theirs: قبول نسختكم أو نسخة الآخرين
• في rebase تُحل التعارضات لكل التزام على حدة
• بعد الحل — لا تنسوا git add و git commit

عند اكتشاف التعارض، أمامكم عدة خيارات. يمكنكم فتح الملف وتعديله يدوياً بحذف علامات التعارض والاحتفاظ بالكود المناسب. ولمن يفضلون العرض المرئي، توجد أدوات مثل meld أو kdiff3 تعرض نسخ الملف الثلاث في وقت واحد. وإذا كنتم متأكدين من تغييراتكم، استخدموا git checkout --ours لإبقاء نسختكم، أو --theirs لقبول نسخة الفرع الآخر. وانتبهوا جيداً عند استخدام rebase، إذ قد تظهر التعارضات في كل التزام يتم إعادة بنائه. بعد اختيار الحل المناسب، أضيفوا الملف وأكملوا الالتزام.

#!/bin/bash
# resolve_strategies.sh

echo "الطريقة 1: الحل اليدوي"
echo 'عدّل الملف بحذف علامات التعارض'
echo 'ثم نفّذ: git add file.txt'

echo "\nالطريقة 2: قبول نسختنا"
git checkout --ours file.txt

echo "\nالطريقة 3: قبول نسختهم"
git checkout --theirs file.txt

echo "\nالطريقة 4: استخدام أداة دمج"
echo 'git mergetool --tool=meld'

echo "\nبعد اختيار الطريقة، أكمل الدمج:"
echo 'git commit -m "حل تعارض الدمج"'