رسالة Git Commit: أفضل الممارسات

Rsalt Git Commit Afdl Almmarsat



في التنمية ، يعد التواصل مع أشخاص آخرين لمراجعة المشروع وفهمه أمرًا مهمًا للغاية. ومع ذلك ، يتطلب Git رسالة للالتزام. إنها أفضل طريقة لتحديد مجموعة متنوعة من التفاصيل حول رسالة الالتزام. يصف ما قام المستخدمون بتعديله في المشروع. على وجه الخصوص ، من المهم كتابة رسالة التزام جيدة يسهل قراءتها وفهمها. لا يهم إذا كان مشروعًا محليًا أو بعيدًا.

سيغطي هذا المنشور ما يلي:







ما هي رسالة Git Commit؟

رسالة الالتزام Git هي شرح موجز للتعديل الذي تم إجراؤه على مستودع Git في نقطة زمنية معينة. إنه سجل للتغييرات التي أجراها المطور ، بما في ذلك تعديلات التعليمات البرمجية والإضافات والحذف.



عندما يغير المستخدمون التعليمات البرمجية الخاصة بهم ، فإنهم يقومون بترتيبها باستخدام ' بوابة إضافة ' يأمر. بمجرد الانتهاء من جميع التغييرات ، سيحتاجون إلى تنفيذ جميع التغييرات. لهذا الغرض ، قم بتنفيذ الأمر 'git الالتزام'. مطلوب رسالة الالتزام لكل التزام ، ويجب أن تصف التغييرات التي تم إجراؤها في الالتزام.



أفضل الممارسات لرسائل Git Commit

هناك عدد كبير من الممارسات لرسائل Git الالتزام. بعضها مذكور أدناه:





  • اجعل رسالة الالتزام قصيرة ومفهومة.
  • يجب أن تكون الرسالة أقل من 40 حرفًا وأن تلخص التعديلات.
  • ابدأ الرسالة دائمًا بفعل مثير للإعجاب ، مثل ' إضافة '،' إصلاح '،' تحديث '،' حذف 'وغيرها الكثير التي تجعل الرسالة واضحة وموجزة.
  • يمكن للمستخدمين توجيه جميع الالتزامات في شكل قائمة أو رمز نقطي.
  • قم بتضمين شرح موجز لسبب إجراء التغييرات في نص رسالة الالتزام. يمكن أن يساعد الآخرين على فهم الأساس المنطقي وراء التغييرات.
  • قم دائمًا بتقسيم الموضوع والجسم بخط فارغ. يؤدي ذلك إلى تحسين قابلية القراءة والمساعدة في تمييز الملخص عن التفاصيل.
  • استخدم نفس التنسيق والنمط لجميع رسائل الالتزام في المشروع.
  • استخدم دائمًا القواعد الإملائية والقواعد الصحيحة.
  • تعمل اللغة الواضحة والصحيحة على تحسين قابلية القراءة والكفاءة المهنية للرسالة.

كيفية إرسال الرسائل في Git؟

لارتكاب رسالة في Git ، اتبع التعليمات الموضحة أدناه:

  • إعادة التوجيه إلى المستودع المطلوب.
  • قم بإنشاء ملف أو تحديثه.
  • تعقب التغييرات على منطقة التدريج.
  • استخدم الأمر 'git الالتزام' بعلامة '-m' لرسالة الالتزام الموجودة فيه.

الخطوة 1: اذهب إلى Local Git Directory

في البداية ، قم بتشغيل محطة Git Bash على نظامك وانتقل إلى المستودع المحلي المطلوب باستخدام ' قرص مضغوط ' يأمر:



قرص مضغوط 'C: \ Users \ user \ Git \ projectrepo'

الخطوة 2: عرض حالة Git

نفذ ' حالة بوابة ”للتحقق من حالة العمل الحالية:

حالة بوابة

تظهر الصورة الناتجة أن منطقة العمل نظيفة وليس هناك ما يلزم الالتزام به:

الخطوة 3: إنشاء الملفات

أنشئ ملفًا في منطقة العمل عن طريق تشغيل الأمر 'touch' مع اسم الملف:

يلمس f3.txt

الخطوة 4: إضافة ملفات لم يتم تعقبها في منطقة التدريج

استخدم الأمر التالي لتعقب التغييرات من منطقة العمل إلى منطقة التدريج:

بوابة إضافة f3.txt

الخطوة 5: تحقق من الملف المتعقب

بعد ذلك ، قم بتشغيل الأمر المذكور أدناه للتحقق مما إذا تم تعقب التغييرات أم لا:

حالة بوابة

يمكن ملاحظة أنه تمت إضافة الملف إلى منطقة التدريج بنجاح:

الخطوة 6: إرسال الرسالة

قم بتنفيذ جميع التغييرات بمساعدة ' بوابة الالتزام ' يأمر:

بوابة الالتزام

يشير الإخراج المقدم أدناه إلى اسم المحرر المحدد ' COMMIT_EDITNSG ' افتتح. أدخل رسالة الالتزام لتنفيذ جميع التغييرات:

بعد إدخال رسالة الالتزام ، احفظ التغييرات بالضغط على ' CTRL + S. 'وإغلاق المحرر. نتيجة لذلك ، تم تنفيذ جميع التغييرات بنجاح:

علاوة على ذلك ، يمكنك أيضًا تحديد الرسالة إلى جانب ' بوابة الالتزام 'الأمر بمساعدة' م ' علَم. على النحو التالي:

بوابة الالتزام م 'تم تعقب التغييرات'

يوضح الناتج أدناه أنه تم الالتزام بجميع التغييرات:

هذا كل ما يتعلق برسالة التزام Git وأفضل الممارسات لها.

خاتمة

رسالة Git الالتزام هي وصف موجز للتعديل الذي تم إجراؤه على مستودع Git في نقطة زمنية معينة. من الضروري وضع بعض النقاط المهمة في الاعتبار حول كتابة رسالة الالتزام ، مثل إبقاء رسالة الالتزام قصيرة ومفهومة. علاوة على ذلك ، يجب أن تكون الرسالة أقل من 40 حرفًا وتلخيص التعديلات. وصف هذا المنشور كل ما يتعلق برسالة Git commits وأفضل ممارساتها.