commit: حفظ مراحل عملك

اللقطة (Commit) هي قلب Git: نقطة محفوظة في تاريخ مشروعك تستطيع العودة إليها متى شئت. في هذا الفصل تتعلم كيف تحفظ عملك، وكيف تقرأ التاريخ، وكيف تتراجع بأمان.

status و add و commit

في Git ثلاث مناطق:

  1. مجلد العمل: ملفاتك كما تعدّلها.
  2. منطقة التجهيز (Staging): التغييرات التي اخترت أن تدخل في اللقطة القادمة.
  3. المستودع: اللقطات المحفوظة.
git status                 # ماذا تغيّر؟
git add index.html         # جهّز ملفًا واحدًا
git add .                  # أو جهّز كل التغييرات
git commit -m "Add about section"

لماذا خطوتان (add ثم commit)؟ لأنك أحيانًا تعدّل أشياء كثيرة وتريد حفظها في لقطات منفصلة: تجهّز ملفات القائمة وتحفظها، ثم ملفات النموذج وتحفظها.

كتابة رسالة commit جيدة

الرسالة تُكتب لك أنت بعد ستة أشهر، ولزملائك. قواعد بسيطة:

  • قصيرة وواضحة، ويفضّل ألا تتجاوز 50 حرفًا في السطر الأول.
  • تصف ماذا تغيّر بفعل أمر: «Add contact form» و«Fix menu on mobile».
  • لقطة واحدة لتغيير واحد له معنى، لا «تعديلات كثيرة».

رسائل سيئة: update و fix و aaa. رسائل جيدة: Fix broken image on services page و Add WhatsApp button to footer. يمكنك الكتابة بالعربية إن أردت، لكن الإنجليزية هي العرف في أغلب المشاريع.

log ورؤية تاريخ المشروع

git log --oneline
a3f9c21 Add contact form
7be41d0 Style services cards
19c0e8a Add about section

كل لقطة لها معرّف (مثل a3f9c21). ولرؤية ما تغيّر:

git diff               # التغييرات التي لم تُجهَّز بعد
git show a3f9c21       # ما الذي تغيّر في هذه اللقطة

التراجع عن التعديلات بأمان

git restore index.html          # تجاهل تعديلاتك على ملف وعُد لآخر لقطة
git restore --staged index.html # أخرج الملف من منطقة التجهيز، وتبقى التعديلات
git revert a3f9c21              # لقطة جديدة تلغي ما فعلته لقطة سابقة

git revert هو الطريقة الآمنة للتراجع عن لقطة، لأنه لا يمحو التاريخ بل يضيف إليه. ستقرأ عن git reset --hard في الإنترنت؛ تجنّبه حتى تفهمه جيدًا، فهو يمحو العمل بلا رجعة.

مهمتك

اعمل على مشروعك واحفظ خمس لقطات على الأقل، لكل منها رسالة واضحة. ثم اعرض التاريخ بـ git log --oneline، وعدّل ملفًا بشكل خاطئ عمدًا وتراجع عنه بـ git restore.