git revert مقابل git reset — سؤال واحد يقرر

■فضاء · مسار النثر

عرض المستودع المستهلك

دقيقتان في مستودع مستهلك، ويصير الفرق لم يعد تعريفاً — بل سجلاً شاهدتَ عيناك عليه:

git init /tmp/revert-vs-reset && cd /tmp/revert-vs-reset
echo one > file.txt && git add . && git commit -m "one"
echo two > file.txt && git add . && git commit -m "two"

git revert --no-edit HEAD
git log --oneline
# 1a2b3c4 (HEAD -> main) Revert "two"   ← the cancellation
# 5d6e7f8 two                          ← still in the log
# 9f8e7d6 one

git reset --hard HEAD~1
git log --oneline
# 9f8e7d6 one                          ← "two" is unreachable

verify: بعد الـrevert git log --oneline → 3 إلزامات · بعد الـreset → إلزام واحد — اللاتماثل هو الجواب كله

أوضاع الـreset الثلاثة

الأوضاع تضبط أين تنجو تعديلاتك بعد تحريك المؤشر — وفي هذا الجدول صفٌ واحد فقط يمحو عملاً:

• git reset --soft HEAD~1 — «أرسلتُ الإلزام مبكراً.» كل شيء يعود stage، جاهزاً لإلزام جديد.
• git reset HEAD~1 (mixed) — «وضعتُ الملفات الخاطئة في الـstage.» التعديلات تنجو في الشجرة العاملة، ولا شيء stage. رافقه بـclean إن أردت أيضاً إزالة الملفات المهملة.
• git reset --hard HEAD~1 — «هذا الإلزام وتعديلاتي غير المرسَلة قمامة.» Git لن يسأل مرتين؛ ولا إبطالَ لجزء الشجرة العاملة إلا إن أودعتَها stash أو أرسلتَها إلزاماً أولاً.

verify: git reset --soft HEAD~1 → يظهر git status التغيير «to be committed» · --mixed → «changes not staged»

revert بلا أوضاع لأنه لا يهدم شيئاً قط — بل يلحق إلزاماً موازناً فقط.

السؤال الوحيد

هل سحب حدٌ غيرك هذا الإلزام؟ إن نعم، فالـreset خارج الحساب. تصفير فرع بُنيت عليه أعمال الآخرين يعيد كتابة التاريخ المشترك: pull هم القادم يفوق فروعاً منشقة، و«الإصلاح» عادةً force-push يجعل خطأك مشكلة الجميع. أما الـrevert فيلحق إلزاماً عادياً، فيلمح ببساطة مع الجميع — ولهذا يبقى الـrevert الجواب الافتراضي على git pull وفي pull requests GitHub، حيث زر «Revert» موجود بالذات لأن قلب التاريخ بعد دمج الـPR ليس خياراً.main وفي pull requests GitHub، حيث زر «Revert» موجود بالذات لأن قلب التاريخ بعد دمج الـPR ليس خياراً.

الفرق بين الاثنين: الـreset للنافذة قبل المشاركة: إلزام منذ ثلاثين ثانية، زلة في الـstage، فرع تجارب محلي. إن كانت النسخة الوحيدة من عملك في ماكينتك، فأنت حر في إعادة ترتيب التاريخ — وهذا كله معنى النافذة قبل الـpush. الحالة الوسطى: أرسلتَ push إلى فرعك الخاص ولم يبنِ عليه أحد — فالـforce-push بعد التصفير مقبول عرفاً هناك، لكن الـrevert ما يزال أقل كلفة تنسيقاً. احجز الـforce-push لفرعٍ تملكه وحدك.

الـrevert أأمن بنائياً، لا بالعرف فقط: الـrevert ينبت إلزاماً عادياً — الـCI يجراه، والرقعة قابلة للعرض، وgit log يشرح لك في المستقبل لماذا تلاشى التغيير. أما الـreset فيدين الحالة الوسيطة في صمت؛ لا يراجعَ بعده أحدٌ ما أُبطل ولا متى.

قسّمان حادّان في الـrevert

• إبطالُ إلزام دمجٍ يطلب git revert -m 1 <sha> — للدمج أبوان، فـ«أبطلْه» أمرٌ مُبهَم؛ -m 1 يُبقي الخط الذي دمجت منه. دونه يرفض git. فخّ المتابعة: إعادة دمج الفرع نفسه ذلك بعدها تظهر عند git كمطبَّقٍ سلفاً، فإعادة هبوط العمل تعني إبطالَ الإبطال.
• الـrevert ليس آلة زمن — يبطل رقعة إلزام واحد. لمست الإلزامات اللاحقة الأسطرَ نفسها، فقد لزم حلَّ إزاحات: git يخبِرك بأن الإبطال مشتبه — معلومة أصل، لا عُطل.

أين يجلس الـrestore

git restore (وgit switch، قرينه) وصلا في git 2.23 ليتولاها أعمالاً كان الـreset يؤمّ لها بسهولة الاسم المخصوم:

التقسيم الحديث: الـrestore يُصلح الملفات، والـreset يحرك الفروع، والـrevert يبطل الإلزامات المنشورة. إنها خطة عقل واحدة ممزوجة على ثلاثة أوامر. الأشكال القديمة لـgit checkout تعمل في كل مقام؛ والجديدة لا تمنع إلا أن تدفع فرعاً كاملاً إلى المجزّر وأنت أردت إخراج ملف واحد من الـstage.

الخلاصة

1. الإلزام علني (مُرسَل، سحبه غيركم) → git revert <sha>.
2. الإلزام محلي، تريد إعادته → git reset --soft أو --mixed ثم إلزام من جديد.
3. محلي، تريد ذهابه مع الفوضى غير المرسَلة → git reset --hard، بعد نظرة صريحة إلى ما تحمله الشجرة العاملة من سواها.
4. ملفٌ خرِب → git restore <file> واترك الفرع بشأنه.

verify: git reflog → HEAD@{n} يدل مقامات ما قبل الـreset — git reset --hard HEAD@{1} يعيد الخطوة إلى الخلف

المدخل الخطِر حقاً الوحيد في تلك اللائحة --hard — وكل ما بقي ينهض عبر git reflog — يتذكر الإلزامات المنفصلة نحو 90 يوماً. الخسائر الدائمة في git ضيقة وأكثرها يطلب إضماراً حرفياً؛ والعادة التي تستحق البناء نصف ثانية قد توقَّف قبل --hard، لا تجنّب أدوات git الحادة قاطعاً. وإن بدا لك قائمة الإبطال برمتها تشريعاً — فالنقد موضوع؛ فـjujutsu، نظام النسخ المتوافق مع git، يعيد تصميم هذه الجزئية بالذات.

خِلْف ثنائي الإبطال · لم يُجلب أي شيء · كل شيء محلي