git add

تجهيز التغييرات للحفظ git add

git add ينقل تعديلات الملفّات من مجلّد العمل إلى منطقة التجهيز (staging)، تمهيدًا لتضمينها في commit.

Git يفصل بين ثلاث مناطق: مجلّد العمل (ملفّاتك كما تراها)، منطقة التجهيز (staging area)، والتاريخ المحفوظ (commits). git add هو الجسر بين الأولى والثانية — يخبر Git 'أريد هذا التعديل بالضبط في الـ commit القادم'.

هذا الفصل يتيح لك بناء commit دقيق يحتوي جزءًا من تعديلاتك فقط، لا كل ما عدّلته في الجلسة، حتى لو كنت تعمل على عدّة أشياء بالتوازي في نفس اللحظة.

الصياغة

git add <ملف>
git add .

📄 مثال

git add index.html          # ملف واحد
git add src/ styles.css     # مجلّد وملف معًا
git add .                   # كل التعديلات في المجلّد الحالي
git add -p file.js          # اختيار أجزاء محدّدة تفاعليًا

أهم الخيارات

الخيار	الوظيفة
.	يضيف كل الملفّات المعدّلة والجديدة في المجلّد الحالي وما تحته
-A	يضيف كل التغييرات في المستودع بالكامل، بما فيها الملفّات المحذوفة
-p	وضع تفاعلي لاختيار أجزاء (hunks) محدّدة من ملف بدل الملف كاملًا

💡 نصائح عملية

git add -p مفيد جدًا لفصل تعديلين مختلفين وقعا بالخطأ في نفس الملف قبل الحفظ
git status بعد git add يوضّح دائمًا ما هو مجهّز (أخضر) وما لم يُجهَّز بعد (أحمر)

⚠️ أخطاء شائعة

استخدام git add . بشكل تلقائي دون مراجعة git status أولًا، فتُضاف ملفّات لم تقصد رفعها
الظن أن git add يحفظ التغييرات فعليًا — هو فقط يجهّزها؛ الحفظ الفعلي يحدث بـ git commit

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار GIT الكامل بالعربي.