المقدمة

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

في هذه المقالة، سنناقش كيفية تنفيذ الالتزامات في Git باستخدام git commit -m و git commit، متى يجب استخدام كل منهما، أفضل ممارسات كتابة الالتزامات، وكيفية تجاوز مرحلة التهيئة باستخدام git commit -am.

الفرق بين git commit -m و git commit

1. git commit -m "رسالة الالتزام"

يُستخدم هذا الأمر لتنفيذ الالتزام مباشرة مع توفير رسالة وصفية قصيرة:

git commit -m "إصلاح خطأ في تسجيل الدخول"

متى يجب استخدامه؟

• عند إجراء تغييرات صغيرة وواضحة لا تحتاج إلى وصف تفصيلي.
• عند العمل بمفردك أو عندما لا يتطلب التزامك مراجعة مطولة.

2. git commit

عند تشغيل هذا الأمر دون تحديد رسالة باستخدام -m، سيفتح Git محرر النصوص الافتراضي ليسمح لك بإدخال رسالة الالتزام بشكل تفصيلي:

git commit

متى يجب استخدامه؟

• عندما تحتاج إلى تقديم وصف أكثر تفصيلًا حول التعديلات.
• عندما تعمل ضمن فريق، وتحتاج إلى تقديم سجل واضح للتعديلات التي تمت.
• عند استخدام معايير التوثيق مثل “عناوين الالتزامات متعددة الأسطر”.

أفضل ممارسات كتابة رسائل الالتزامات

1. لا يجب أن يكون الالتزام كبيرًا جدًا أو صغيرًا جدًا

• الالتزامات الكبيرة جدًا تجعل من الصعب فهم التغييرات وتتبع الأخطاء.
• الالتزامات الصغيرة جدًا قد تؤدي إلى سجلات غير ضرورية.
• القاعدة العامة: يجب أن يعكس كل التزام جزءًا منطقيًا من التغييرات.

2. لا تخلط تغييرات متعددة في التزام واحد

من الأفضل فصل التعديلات المختلفة إلى التزامات مستقلة، مثل:

• التعديلات على الميزات الجديدة.
• إصلاحات الأخطاء.
• تحديثات توثيق.

مثال خاطئ:

git commit -m "إصلاح خطأ إملائي + إصلاح مشكلة تحميل الصفحة"

مثال صحيح:

git commit -m "إصلاح مشكلة تحميل الصفحة عند تسجيل الدخول"
git add README
git commit -m "إصلاح خطأ إملائي في ملف README"

3. اجعل رسالة الالتزام ذات معنى

• تجنب الرسائل غير الواضحة مثل:

git commit -m "تعديلات"

• بدلاً من ذلك، استخدم وصفًا دقيقًا:

git commit -m "تحسين أداء تحميل البيانات في واجهة المستخدم"

4. استخدم صيغة المضارع وتجنب الماضي

• خطأ: تم إصلاح خطأ في تسجيل الدخول
• صحيح: إصلاح خطأ في تسجيل الدخول

تجاوز مرحلة التهيئة باستخدام git commit -am

ما هو git commit -am؟

هذا الأمر يسمح لك بتخطي git add وإضافة جميع التعديلات المتعقبة مباشرة إلى الالتزام:

git commit -am "تحسين تخزين البيانات"

متى يجب استخدامه؟

• عندما تكون متأكدًا من جميع التغييرات.
• عند تحديث الملفات المتعقبة مسبقًا.

متى لا يجب استخدامه؟

• عند إضافة ملفات جديدة، لأنه لا يشمل الملفات غير المتعقبة.
• عندما تحتاج إلى تجزئة التعديلات إلى التزامات متعددة.

الخاتمة

يعد فهم عملية الالتزام في Git أمرًا أساسيًا للحفاظ على سجل منظم للمشروع. باستخدام git commit -m و git commit بذكاء، والالتزام بأفضل الممارسات، يمكنك تحسين طريقة عملك وجعل الكود الخاص بك أكثر وضوحًا وسهولة في التتبع.

🚀 برمجة سعيدة!