عاجلًا أو آجلًا سيغيّر فرعان السطر نفسه. تغيّر سطر التعريف (tagline) على main إلى “Front-end developer in Lagos.”، بينما فرعك tagline الذي بدأته في وقت سابق أعاد كتابة السطر نفسه إلى “Front-end developer who loves accessible UI.”. لا يستطيع Git أن يعرف أيهما الصحيح، فيتوقّف ويسأل. هذا كل ما في تعارض الدمج (merge conflict): سؤال. ساعدت مئات الأشخاص في تعارضهم الأول، والذعر يأتي دائمًا من العلامات غير المألوفة، لا من المشكلة نفسها.
git switch main\ngit merge taglineAuto-merging index.html\nCONFLICT (content): Merge conflict in index.html\nAutomatic merge failed; fix conflicts and then commit the result.أنت الآن في منتصف دمج. الملفات التي اندمجت بلا مشكلة مجهّزة أصلًا. شغّل git status لترى البقية:
On branch main\nYou have unmerged paths.\n (fix conflicts and run "git commit")\n (use "git merge --abort" to abort the merge)\n\nUnmerged paths:\n (use "git add <file>..." to mark resolution)\n\tboth modified: index.html\n\nno changes added to commit (use "git add" and/or "git commit -a")اقرأ هذا الناتج؛ ففيه الإجراء كاملًا. أصلح التعارضات، وعلّم كل ملف بأنه حُلّ بـ git add، ثم git commit. أو ألغِ الدمج.
افتح index.html. كتب Git النسختين كلتيهما في الملف، محاطتين بعلامات:
<h1>Maya Okafor</h1>\n<<<<<<< HEAD\n <p>Front-end developer in Lagos.</p>\n=======\n <p>Front-end developer who loves accessible UI.</p>\n>>>>>>> taglineHEAD حتى =======، هو طرفك: الفرع الذي أنت عليه، وهو هنا main.======= حتى العلامة الختامية التي تحمل الاسم tagline، هو طرفهم: الفرع الذي تدمجه.كل ما هو خارج العلامات اندمج دون مشكلة. وقد يحتوي الملف عدة كتل من هذا النوع، فابحث في الملف عن العلامة الافتتاحية (سبعة رموز < متتالية) حتى لا يبقى منها شيء.
1. قرّر ما يجب أن تكون عليه النتيجة. ليس «أيّ الطرفين يفوز» كردّ فعل تلقائي، بل ما الذي يجب أن تقوله الصفحة فعلًا؟ غالبًا تكون النتيجة مزيجًا. وهنا المعلومتان كلتاهما جيدتان:
\n <h1>Maya Okafor</h1>\n <p>Front-end developer in Lagos who loves accessible UI.</p>2. أزل كل العلامات. يجب أن تختفي أسطر العلامات الثلاثة. لا يقرأ Git الملف ليتحقّق؛ هذه مهمّتك أنت.
\n3. افحص النتيجة. افتح الصفحة في المتصفّح، وشغّل اختباراتك (npm test حين تصبح للموقع اختبارات)، وشغّل:
git diff --checkينبّهك إلى أي علامات تعارض متبقّية. خمس ثوانٍ في محلّها.
\n4. علّمه بأنه حُلّ وأكمل.
\ngit add index.html\ngit status # \"All conflicts fixed but you are still merging.\"\ngit commit # editor opens with \"Merge branch 'tagline'\"; save and closeالأمر git merge --continue يفعل ما يفعله git commit الأخير هذا. والـ merge commit الآن له أبوان، كأي merge commit آخر.
وإن كنت تعرف أن أحد الطرفين يجب أن يفوز في ملف كامل، فتجاوز التحرير: git restore --ours index.html يحتفظ بنسخة فرعك، و git restore --theirs index.html يحتفظ بالنسخة القادمة. ثم نفّذ git add كالمعتاد.
إن كان التعارض أكبر مما توقّعت، أو دمجت الفرع الخطأ، تستطيع دائمًا التراجع:
\ngit merge --abortيعود فرعك والـ index وملفاتك تمامًا إلى ما كانت عليه قبل git merge. لا يضيع شيء. وكثيرًا ما يكون من الحكمة أن تلغي، ثم تحدّث الفرع أو ترتّبه، وتحاول من جديد بذهن صافٍ.
العلامات نفسها وروتين «أصلِح ثم add ثم أكمل» نفسه يظهران كلما جمع Git نسختين من سطر واحد: أثناء الـ rebase، وحين تطبّق stash، وحين يدمج git pull عمل شخص آخر في عملك. تعلّم الروتين مرة واحدة هنا، وسيبدو كل تعارض لاحق في هذا الكورس مألوفًا. ما يتغيّر فقط هو الأمر الذي تستخدمه للإكمال أو الإلغاء.
افتراضيًا ترى الطرفين فقط. اطلب من Git أن يعرض الأسطر الأصلية أيضًا:
\ngit config --global merge.conflictStyle zdiff3الآن لكل تعارض قسم ثالث بين ||||||| و ======= يعرض الـ merge base. رؤية ما كان عليه السطر قبل أيّ من التغييرين تجعل الجواب الصحيح واضحًا في الغالب: ترى ما قصده كل طرف، لا ما انتهى إليه فقط.
المحرّرات تساعد أيضًا. يميّز VS Code كل كتلة بأزرار مثل Accept Current Change و Accept Incoming Change و Accept Both Changes، إضافة إلى محرّر دمج ثلاثي. استخدمها، لكن اقرأ النتيجة؛ فـ Accept Both كثيرًا ما ينتج وسمَي <p> حيث أردت واحدًا.
الدمج طريقة واحدة لجمع السجلّات. في الدرس التالي ستتعرّف على الطريقة الأخرى، الـ rebase، والقاعدة الوحيدة التي تُبقيه آمنًا.
\n","toc":[{"id":"sec-1","text":"ما يخبرك به Git","level":2},{"id":"sec-2","text":"قراءة العلامات","level":2},{"id":"sec-3","text":"الحلّ خطوة بخطوة","level":2},{"id":"sec-4","text":"الانسحاب","level":2},{"id":"sec-5","text":"جعل التعارضات أسهل في القراءة","level":2}],"takeaways":["التعارض يعني أن الفرعين غيّرا الأسطر نفسها منذ الـ merge base، فيطلب منك Git أن تختار؛ لا شيء ضاع ولا شيء تعطّل.","ما بين<<<<<<< و ======= هو فرعك الحالي (HEAD)؛ وما بين ======= و >>>>>>> هو الفرع الذي يُدمج.","تحلّ التعارض بتحرير الملف إلى شكله النهائي، وإزالة كل العلامات، ثم git add للملف و git commit.","git merge --abort يعيد كل شيء تمامًا كما كان قبل بدء الدمج.","ضبط merge.conflictStyle على zdiff3 يعرض الأسطر الأصلية أيضًا، وهذا يجعل الحكم على معظم التعارضات سهلًا."],"further":[{"title":"Basic Merge Conflicts (Pro Git)","url":"https://git-scm.com/book/en/v2/Git-Branching-Basic-Branching-and-Merging#_basic_merge_conflicts"},{"title":"Resolving a merge conflict using the command line","url":"https://docs.github.com/en/pull-requests/how-tos/merge-and-close-pull-requests/resolving-a-merge-conflict-using-the-command-line"},{"title":"git merge, How conflicts are presented","url":"https://git-scm.com/docs/git-merge#_how_conflicts_are_presented"}],"quiz":[{"q":"أنت على main وشغّلت git merge tagline. وترى في index.html:
<<<<<<< HEAD\n<p>Front-end developer in Lagos.</p>\n=======\n<p>Front-end developer who loves accessible UI.</p>\n>>>>>>> taglineأيّ السطرين جاء من main؟
Front-end developer in Lagos.، لأن النصف العلوي هو الـ HEAD، أي فرعك الحالي.","why":"صحيح. أنت على main، إذن الـ HEAD هو main. والنصف السفلي، الذي يحمل الاسم tagline، هو ما يُدمج."},{"text":"لا هذا ولا ذاك؛ السطران اقتراحان من Git لنسخة مدمجة.","why":"لا يخترع Git نصوصًا. كل نصف هو بالضبط ما يحتويه أحد الفرعين."}],"answer":1},{"q":"حرّرت index.html حتى صار كما تريد، وأزلت كل العلامات. لكن git status ما زال يدرجه تحت “Unmerged paths”. ما الخطوة التالية؟
git merge tagline مجددًا كي يلاحظ Git الإصلاح.","why":"هناك دمج قيد التنفيذ أصلًا. بدء دمج آخر يفشل؛ فـ Git ينتظر منك أن تعلّم الملفات بأنها حُلّت."},{"text":"شغّل git commit -a --no-verify.","why":"--no-verify يتخطّى الـ hooks ولا علاقة له بالتعارضات. جهّز الملف وأنشئ الـ commit بشكل عادي."},{"text":"شغّل git add index.html لتعلّمه بأنه حُلّ، ثم git commit.","why":"صحيح. التجهيز يخبر Git بأن التعارض حُسم. وحين لا يبقى أي مسار غير مدموج، ينشئ git commit الـ merge commit."},{"text":"احذف index.html وشغّل git restore index.html.","why":"هذا يرمي الحلّ الذي كتبته للتو. ولا داعي لحذف أي شيء."}],"answer":2},{"q":"في منتصف تعارض فوضوي تدرك أنك دمجت الفرع الخطأ. كيف تعود تمامًا إلى حيث كنت قبل الدمج؟
","options":[{"text":"git merge --abort","why":"صحيح. ما دام الدمج قيد التنفيذ، يعيد هذا الأمر الفرع والـ index وملفاتك إلى حالتها قبل git merge."},{"text":"git restore .","why":"هذا يرمي تغييرات الـ working tree لكنه يترك Git في منتصف الدمج، وحالة الدمج ما زالت نشطة."},{"text":"git branch -D main","why":"حذف الفرع الذي أنت عليه غير مسموح، ولن يلغي أي شيء على أي حال."},{"text":"أغلق الطرفية؛ فعمليات الدمج غير المكتملة تُلغى تلقائيًا.","why":"حالة الدمج مخزّنة في .git، لا في جلسة الطرفية. وستجدها حين تعيد فتحها."}],"answer":0},{"q":"دُمج فرعك ورُفع، ثم يجد زميلك ======= مطبوعة على الصفحة الرئيسية في الموقع المنشور. أيّ عادة كانت ستكتشف هذا قبل الـ commit؟
git log --graph بعد كل دمج.","why":"الرسم يعرض بنية الـ commits، لا محتوى الملفات، فلن تظهر العلامات المتبقّية."},{"text":"الحلّ دائمًا بـ git merge --abort.","why":"الإلغاء يلغي الدمج بدل أن يحلّه، فلا يصل العمل أبدًا."},{"text":"استخدام git commit -m بدل المحرّر.","why":"مصدر الرسالة لا علاقة له بالعلامات الموجودة داخل ملفاتك."},{"text":"تشغيل git diff --check (وفتح الصفحة) قبل git add.","why":"صحيح. git diff --check ينبّه إلى علامات التعارض المتبقّية، والنظر الفعلي إلى النتيجة يكشف الباقي."}],"answer":3}],"exercise":{"kind":"order","items":["merge","status","open","edit","check","add","commit"],"title":"حُلّ تعارض سطر التعريف","prompt":"أنت على main وتريد دمج فرع tagline. رتّب الخطوات بالترتيب الذي ستنفّذها به لتنتقل من التعارض إلى merge commit مكتمل.
git status يخبرك أيّ الملفات تحتاجك.","تصلح الملف قبل أن تفحصه، وتفحصه قبل أن تخبر Git بأنه حُلّ.","الـ merge commit هو الخطوة الأخيرة دائمًا."],"explanation":"يتوقّف الدمج عند التعارض؛ ويدرج git status الملفات غير المدموجة. تفتح كل ملف منها، وتحرّره إلى النص النهائي وتحذف كل علامة، ثم تفحص النتيجة (git diff --check، والنظر إلى الصفحة، وتشغيل الاختبارات). بعد ذلك فقط يعلّمه git add بأنه حُلّ، ويسجّل git commit (أو git merge --continue) الـ merge commit. وإن ساء أي شيء قبل تلك الخطوة الأخيرة، يعيدك git merge --abort إلى حيث بدأت.
git merge tagline لترى CONFLICT (content): Merge conflict in index.html.","status":"شغّل git status لعرض المسارات غير المدموجة.","open":"افتح index.html وجِد كتلة <<<<<<<.","edit":"اكتب سطر التعريف النهائي واحذف أسطر العلامات الثلاثة.","check":"شغّل git diff --check وانظر إلى الصفحة في المتصفّح.","add":"شغّل git add index.html لتعلّم التعارض بأنه حُلّ.","commit":"شغّل git commit لتسجيل الـ merge commit."}},"words":662,"readMinutes":4}