أضفت ملفًا إلى تجهيز commit ثم اكتشفت أنه يحتاج مراجعة إضافية. وقد واصلت تعديله بعد git add، فأصبح لديك محتوى مجهز ومحتوى أحدث في المحرر. قبل استخدام أمر يعيد ملفات، اختبر تحديدًا أي نسخة سيتغير محتواها. هذا المثال يركز على إخراج ملف واحد من التجهيز مع إبقاء التعديل الموجود على القرص.
ابنِ ثلاث حالات واضحة
نفّذ التجربة داخل مستودع جديد مؤقت. احفظ note.txt بالمحتوى A وأنشئ commit. غيّره إلى B ونفّذ git add، ثم غيّره إلى C دون إضافة ثانية. الآن تحتوي آخر مراجعة HEAD على A، والفهرس على B، والملف الفعلي على C. اختلاف القيم يجعل أثر كل أمر قابلًا للقياس.
git show HEAD:note.txt
git show :note.txt
git diff -- note.txt
git diff --cached -- note.txt
git restore --staged -- note.txt
git show :note.txt
git diff -- note.txt
افحص النسخة المجهزة والملف
بعد الأمر، يعرض الفهرس A مرة أخرى، ويظل الملف نفسه C. يصبح الفرق غير المجهز بين A وC، ويصبح git diff --cached لذلك الملف فارغًا. اقرأ note.txt من القرص للتأكد من الاحتفاظ بآخر تعديل. لا تعتمد فقط على اختفاء الملف من خانة التجهيز في واجهة المحرر.
عند استخدام --staged دون تحديد مصدر، يعتمد restore على HEAD لتحديث الفهرس. إضافة --worktree تغيّر نطاق العملية لتشمل ملفات العمل، لذلك راجع الخيارات قبل تشغيل أمر منسوخ. الأمر المعروض هنا يحدد مسارًا واحدًا بعد -- حتى يكون نطاق الاختبار واضحًا.
جرّب ملفًا جديدًا أيضًا
أضف ملفًا جديدًا إلى التجهيز ثم استخدم نفس الأمر له في مستودع لديه commit سابق. يجب أن يخرج من الفهرس ويظل موجودًا كملف غير متتبع. جرّب كذلك مسارًا فيه مسافة مع إحاطته بعلامات اقتباس مناسبة للصدفة. اختلاف حالة الملف يكشف لماذا لا تكفي تجربة واحدة على ملف قديم.
لو كان الملف يحتوي جزءًا يصلح للنشر وجزءًا يحتاج الانتظار، راجع اختيار المقاطع بواسطة أدوات Git المناسبة بعد فهم حالة الفهرس. لا تجمع عملية إعادة تنظيم التجهيز مع حذف ملفات أو تغيير فرع في تجربة واحدة، حتى تعرف سبب كل نتيجة وتحتفظ بالتعديلات التي تعمل عليها.
قبل إنشاء المراجعة
- راجع git status لمعرفة الملفات الداخلة فعليًا.
- افتح git diff --cached واقرأ التغييرات التي سيحفظها commit.
- افحص الملفات غير المتتبعة التي قد تحتاج إضافتها لاحقًا.
- تحقق من بقاء محتوى المحرر الذي كنت تريد مواصلة تعديله.
يمكن اعتماد هذه العينة كتمرين أثناء تسليم مشروع برمجي، مع توثيق طريقة المراجعة في اتفاق العمل مع فريق التطوير.




