كل شخص يكسر شيئًا في Git عاجلًا أو آجلًا. تنشئ commit على الفرع الخطأ، أو ترفع خطأً برمجيًا، أو تمحو عمل صباح كامل بـ reset. والخبر الجيد: نادرًا ما يرمي Git البيانات، ولمعظم الأخطاء طريقة تراجع نظيفة. الفخّ هو أن تلجأ إلى أي أمر تراجع تتذكّره نصف تذكّر. اختر بطرح سؤال واحد: أين يعيش الخطأ؟
\n| أين الخطأ | \nالأمر | \nهل يعيد كتابة السجلّ؟ | \n
|---|---|---|
| تعديلات غير مجهّزة في ملف | \ngit restore <file> | \nلا (لكنه يرمي التعديلات) | \n
| مجهّز، لم يُسجَّل في commit | \ngit restore --staged <file> | \nلا | \n
| آخر commit، لم يُرفع | \ngit commit --amend | \nنعم، الـ commit المحلي فقط | \n
| commits محلية، لم تُرفع | \ngit reset | \nنعم، محليًا فقط | \n
| commits رُفعت وتمّت مشاركتها | \ngit revert <commit> | \nلا | \n
يتبع الجدول قاعدة واحدة: حين يصبح commit ما لدى آخرين، تضيف فوقه commits جديدة بدل أن تغيّره.
\nنسيت ملفًا أو كتبت رسالة سيئة، ولم ترفع بعد؟
\ngit add contact.css\ngit commit --amend --no-edit # same message, file included\ngit commit --amend -m \"Add contact form\" # or a new messageالـ amend لا يعدّل الـ commit؛ بل يستبدله بآخر جديد بمعرّف جديد. هذا مقبول محليًا، ومشكلة إن كنت قد رفعت، للسبب نفسه الذي يجعل الـ rebase مشكلة.
\nدمجت في main commit عطّل قائمة التنقّل على الجوال. وقد رُفع، وسحبه زملاؤك. لا تُعِد كتابة أي شيء. أضف commit يعكسه:
git revert HEAD # if it's the latest commit\ngit revert 8f1e2aa # or any commit by IDينشئ Git commit جديدًا، Revert "Move nav into header"، يطبّق التغييرات المعاكسة تمامًا. ويظل السجلّ يُظهر الخطأ وإصلاحه، وهذا صادق وآمن: يحصل الجميع على الـ revert بـ pull عادي. وللتراجع عن merge commit، أخبر Git أيّ الأبوين يُعتمد خطًا رئيسيًا (mainline)، وهو الأول عادةً: git revert -m 1 <merge-commit>.
أحيانًا يكون جزء فقط من الـ commit خاطئًا. إن كان نقل قائمة التنقّل سليمًا باستثناء styles.css، فلا داعي للتراجع عن الـ commit كله. أعِد ذلك الملف وحده إلى ما كان عليه قبل الـ commit، وافحصه، وسجّل النتيجة في commit إصلاح عادي:
git restore --source=8f1e2aa~1 styles.css\ngit diff\ngit commit -am \"Restore mobile nav styles\"هذا ما زال «إضافة إلى السجلّ لا إعادة كتابة له»، لكن بنطاق أصغر.
\ngit reset <commit> يحرّك الفرع الحالي إلى commit آخر. وما يفعله بالـ index والـ working tree يعتمد على الوضع (mode)، وهنا يتأذّى الناس.
ثلاث حالات، وثلاثة أوضاع:
\ngit reset --soft HEAD~2 # squash: the last two commits' changes become staged, ready for one commit\ngit reset HEAD~1 # un-commit (--mixed): changes return as unstaged edits to rework\ngit reset --hard HEAD~1 # discard: the commit and its changes are gone from the branch and filesاستخدام كلاسيكي: أنشأت commit على main بينما كنت تقصد أن تكون على فرع. سجّل أي تعديلات غير مسجّلة أو خبّئها أولًا (فـ --hard سيمحوها)، ثم أنشئ الفرع حيث أنت، ثم أرجِع main:
git branch contact-form # the branch keeps your commit\ngit reset --hard origin/main # main goes back to match GitHub\ngit switch contact-formهذه هي شبكة الأمان التي تجعل كل ما سبق أقل إخافة. في كل مرة يتحرّك فيها الـ HEAD (commit، أو switch، أو reset، أو rebase، أو merge)، يكتب Git سطرًا في الـ reflog:
\ngit reflog2b7f0c1 (HEAD -> main) HEAD@{0}: reset: moving to HEAD~3\n9e4a1d5 HEAD@{1}: commit: Add contact form validation\n4c8b2e7 HEAD@{2}: commit: Add contact form\na71d3f0 HEAD@{3}: checkout: moving from footer to mainبعد ذلك الـ git reset --hard HEAD~3 العرَضي، لم تعد الـ commits الثلاثة على أي فرع، لكنها ما زالت موجودة، و HEAD@{1} يشير إلى أحدثها. استعدها:
git reset --hard HEAD@{1} # put main back where it was\n# or, more cautiously, keep them on a new branch to inspect first\ngit switch -c rescue 9e4a1d5الـ reflog محلي (لا يُرفع ولا يُستنسخ)، وسطوره تنتهي صلاحيتها: افتراضيًا بعد 90 يومًا، أو 30 يومًا للـ commits التي لا يصل إليها أي فرع. وهذا وقت أكثر من كافٍ لملاحظة الخطأ.
\nما لا يستطيع الـ reflog إنقاذه هو العمل الذي لم يُسجَّل قط. فـ git restore و git reset --hard يكتبان فوق التعديلات غير المسجّلة في ملفاتك، ولا يعرف أي سجلّ عنها شيئًا. لذا فعادة الأمان الحقيقية بسيطة: أنشئ commits مبكرًا وكثيرًا على فرعك. تستطيع دائمًا ضغط الـ commits قبل المراجعة؛ لكنك لا تستطيع استعادة تعديلات لم تسجّلها قط.
لكن بعض العمل الجاري ليس جاهزًا ليُسجَّل في commit. في الدرس التالي ستركنه جانبًا بـ git stash، وتمنع Git من تتبّع ملفات ما كان يجب أن يتتبّعها أصلًا.
git revert <commit> يضيف commit جديدًا يلغي commit قديمًا، وهي الطريقة الآمنة للتراجع عن أي شيء رُفع بالفعل.","git reset يحرّك الفرع الحالي: --soft يُبقي التغييرات مجهّزة، و --mixed يُبقيها غير مجهّزة، و --hard يرميها.","git commit --amend يستبدل آخر commit، لذا استخدمه قبل الرفع فقط.","git reflog يسرد الأماكن التي مرّ بها الـ HEAD، فيمكن العثور على commits ضاعت بسبب reset أو rebase واستعادتها لأسابيع بعد ذلك."],"further":[{"title":"Undoing Things (Pro Git)","url":"https://git-scm.com/book/en/v2/Git-Basics-Undoing-Things"},{"title":"Reset Demystified (Pro Git)","url":"https://git-scm.com/book/en/v2/Git-Tools-Reset-Demystified"},{"title":"git revert reference","url":"https://git-scm.com/docs/git-revert"},{"title":"git reflog reference","url":"https://git-scm.com/docs/git-reflog"}],"quiz":[{"q":"أنشأت commit باسم “Add contact form” قبل دقيقة، ولم ترفعه، ثم أدركت أنك نسيت تجهيز contact.css. ما الإصلاح الأنظف؟
git revert HEAD، ثم أنشئ commit من جديد بالملفين.","why":"هذا يترك commitين زائدين (الأصلي وعكسه) في السجلّ بسبب خطأ لم يره أحد غيرك."},{"text":"git reset --hard HEAD~1 وأعِد العمل.","why":"--hard يرمي التغييرات المسجّلة من ملفاتك. ستعيد كتابة النموذج بيدك."},{"text":"git add contact.css، ثم git commit --amend --no-edit.","why":"صحيح. الـ amend يستبدل آخر commit غير مرفوع بآخر يتضمّن الملف؛ و --no-edit يُبقي الرسالة."},{"text":"git restore --staged contact.css","why":"هذا يلغي تجهيز ملف. و contact.css ليس مجهّزًا بعد، وسيظل الـ commit يفتقده."}],"answer":2},{"q":"بالأمس دمجت في main commit عطّل قائمة التنقّل على الجوال. وقد رُفع وسحبه زملاؤك. كيف تتراجع عنه؟
git revert <commit> وارفع الـ commit الجديد.","why":"صحيح. الـ revert يسجّل commit جديدًا يطبّق التغيير المعاكس، فلا تُعاد كتابة سجلّ أحد، ويحصل الجميع على الإصلاح بـ pull عادي."},{"text":"git reset --hard <commit>~1 ثم git push --force.","why":"هذا يعيد كتابة السجلّ المشترك. زملاؤك ما زال لديهم الـ commit السيئ، ورفعهم التالي سيعيده أو يُحدث فوضى."},{"text":"git commit --amend لتعديل الـ commit السيئ وإزالته.","why":"الـ amend لا يلمس إلا آخر commit لديك، وينشئ معرّفًا جديدًا، وسيحتاج أيضًا إلى رفع بالقوة إلى فرع مشترك."},{"text":"git restore --source=HEAD~1 . ثم الرفع دون commit.","why":"استرجاع الملفات يغيّر الـ working tree فقط. ولا يُرفع شيء حتى يُسجَّل في commit."}],"answer":0},{"q":"تشغّل git reset --soft HEAD~2 على commitين غير مرفوعين. أين تغييراتهما الآن؟
--hard. أما --soft فلا يلمس الـ index ولا الـ working tree أبدًا."},{"text":"في الـ working tree لكن غير مجهّزة.","why":"هذا هو الوضع الافتراضي --mixed، الذي يعيد ضبط الـ index أيضًا."},{"text":"ما زالت في الـ commitين، وقد صارا على فرع جديد.","why":"الـ reset لا ينشئ فروعًا. إنه يحرّك مؤشّر الفرع الحالي."},{"text":"مجهّزة في الـ index، جاهزة لتُسجَّل من جديد في commit واحد.","why":"صحيح. تراجع الفرع commitين لكن الـ index والملفات احتفظت بكل شيء، وهي طريقة سريعة لضغط commits محلية."}],"answer":3},{"q":"شغّلت git reset --hard HEAD~3 بالخطأ فاختفت ثلاثة commits من git log. كيف تستعيدها؟
--hard يحذف الـ commits نهائيًا.","why":"الـ reset يحرّك مؤشّرًا. والـ commits ما زالت موجودة، والـ reflog يتذكّر أين كان الـ HEAD."},{"text":"شغّل git reflog، وجِد السطر السابق للـ reset، ثم git reset --hard HEAD@{1}.","why":"صحيح. HEAD@{1} يعني مكان الـ HEAD قبل حركة واحدة، أي قبل الـ reset مباشرة."},{"text":"شغّل git revert HEAD~3.","why":"الـ revert ينشئ commit جديدًا يتراجع عن تغيير. ولا يعيد commits ضائعة إلى فرعك."},{"text":"شغّل git pull، فهو يستعيد أي commits مفقودة.","why":"فقط إن كانت قد رُفعت. الـ pull يجلب ما هو موجود على الـ remote؛ أما الـ commits غير المرفوعة فموجودة في الـ repository المحلي وحده."}],"answer":1}],"exercise":{"kind":"choice","multiple":false,"options":["a","b","c","d"],"correct":["b"],"title":"اختر طريقة التراجع","prompt":"أحدث commit لديك على main، وهو 8f1e2aa Move nav into header، عطّل قائمة الجوال. رفعته قبل ساعة، وسحبه زميلان بالفعل. ويعرض git status working tree نظيفًا.
8f1e2aa (HEAD -> main, origin/main) Move nav into header\nc39be11 Add projects page\nb2e04f3 Add navigation bar with base stylesأيّ أمر يجب أن تشغّله قبل أن ترفع مجددًا؟
\n","hints":["اسأل أين يعيش الخطأ: في ملفاتك، أم في الـ index، أم في commit محلي، أم في commit مشارَك؟","أي شيء يغيّر8f1e2aa نفسه سيحتاج إلى رفع بالقوة إلى فرع سحبه آخرون.","تريد أن تضيف إلى السجلّ، لا أن تعيد كتابته."],"explanation":"الـ commit السيئ مشارَك بالفعل، لذا فإعادة كتابته (بالـ amend أو الـ reset) ستجبر الجميع على إصلاح سجلّاتهم. أما git revert HEAD فيضيف commit جديدًا يطبّق عكس 8f1e2aa تمامًا؛ ارفعه بشكل عادي فيحصل زملاؤك على الإصلاح بـ pull عادي. ولاحقًا تستطيع إصلاح قائمة التنقّل كما يجب على فرع، وإعادة النقل عبر pull request.
git reset --hard HEAD~1، ثم git push --force","why":"هذا يحذف commit يملكه زملاؤك بالفعل. رفعهم التالي قد يعيده، والرفع بالقوة قد يمحو أي شيء رُفع في الأثناء."},"b":{"text":"git revert HEAD، ثم git push","why":"صحيح. الـ commit الجديد يلغي 8f1e2aa دون إعادة كتابة السجلّ المشترك."},"c":{"text":"git restore index.html","why":"الـ working tree نظيف، فلا شيء يُسترجع. الخطأ داخل commit، ولا يستطيع التراجع عنه علنًا إلا commit جديد."},"d":{"text":"git commit --amend","why":"الـ amend يستبدل آخر commit بمعرّف جديد، وهذه إعادة كتابة لـ commit مرفوع وستحتاج إلى رفع بالقوة."}}},"words":671,"readMinutes":4}