إلغاء الأخطاء: الأوامر restore، reset، revert — الاستخدام الصحيح والخطير

Git restore: زر التراجع للملفات

• Git restore — للتراجع عن التغييرات غير المُسجَّلة في commit
• يعمل مثل زر التراجع في محرر الأكواد
• آمن — لا يغيّر سجل commits
• يرجع الملفات إلى آخر حالة مسجلة في commit

تخيل أنك حفظت ملفًا بالخطأ وفيه تعديل غير مرغوب، وتريد إرجاعه كما كان. Git restore يعمل مثل زر التراجع في محرر الأكواد؛ يرجع الملفات إلى آخر حالة مسجلة في commit. وعلى عكس أوامر التراجع الأخرى، restore تتعامل فقط مع التغييرات غير المُسجَّلة في commit، ولا تمس سجل المشروع. هذه أول أداة تلجأ إليها عند حدوث تعديل عشوائي وتريد إصلاح الموقف بسرعة دون مخاطرة بتاريخ التغييرات.

التراجع عن التغييرات في مجلد العمل

• git restore file.txt — يرجع الملف إلى آخر commit
• يلغي جميع التغييرات في مجلد العمل
• آمن لسجل المشروع — لا يغيّر commits، لكنه لا يحتفظ بنسخة من التغييرات المُلغاة
• تحقق من الحالة باستخدام git status قبل الاستعادة

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

# عرض عملي لاستعادة ملف
$ echo "تعديلات خاطئة" > main.py
$ git status
$ git restore main.py
$ cat main.py
$ git status

إزالة ملف من منطقة الترحيل

• git restore --staged file.txt — إزالة ملف من منطقة الترحيل
• يحافظ على التغييرات في مجلد العمل
• انتبه: من دون --staged ستُفقد التغييرات
• افحص دائمًا git status قبل التنفيذ

من الأخطاء الشائعة أن تضيف بالخطأ ملفًا غير مرغوب فيه إلى منطقة الترحيل. مثلًا، نفّذت git add . فأضفت ملف إعدادات مؤقتًا. أمر git restore مع الخيار --staged واسم الملف settings.tmp سيزيله من منطقة الترحيل بأمان، مع الإبقاء على كل تغييراته في مجلد العمل. من دون الخيار --staged ستفقد تعديلاتك، لذلك افحص الحالة دائمًا باستخدام git status قبل تشغيل restore. الآن أصبحت تعرف كيف تلغي التغييرات قبل الإيداع. لكن ماذا لو دخل الخطأ بالفعل في سجل الإيداعات؟ هنا يأتي دور git reset.

# أضفنا ملفًا إلى منطقة الترحيل بالخطأ
$ git add config.tmp
$ git status

# نزيله من منطقة الترحيل مع الإبقاء على التغييرات
$ git restore --staged config.tmp
$ git status

# نتحقق من بقاء الملف في مجلد العمل
$ ls -la config.tmp