Menu
Coddy logo textTech
flag Ar iconالعربيةdown icon

قواعد التسمية

جزء من قسم Fundamentals في رحلة C# على Coddy — الدرس 12 من 69.

اصطلاحات التسمية تشبه قواعد الطريق للمبرمجين. فهي تساعد في الحفاظ على الكود منظماً ومفهوماً.

تخيل لو كانت لافتات الشوارع عشوائية وغير متسقة - ستعم الفوضى! وبالمثل، بدون اتفاقيات التسمية، يمكن أن تصبح التعليمات البرمجية فوضوية ومربكة.

في لغة C#، يعد اتباع اتفاقيات تسمية متسقة أمراً بالغ الأهمية لكتابة كود نظيف، وقابل للصيانة، وتشاركي. إليك بعض الاتفاقيات الرئيسية التي يجب وضعها في الاعتبار:

  • PascalCase: يُستخدم لأسماء الفئات (class names)، وأسماء الدوال (method names)، وأسماء الخصائص (property names). تبدأ كل كلمة بحرف كبير، على سبيل المثال: MyClass، CalculateTotal، FirstName.
  • camelCase: تُستخدم للمتغيرات المحلية ومعاملات الدوال (method parameters). تبدأ الكلمة الأولى بحرف صغير، وكل كلمة تالية تبدأ بحرف كبير، على سبيل المثال: myVariable، customerName، calculateTotal.
  • _underscorePrefix: يُستخدم للحقول الخاصة (المتغيرات داخل الفئة). ابدأ بشرطة سفلية متبوعة بتنسيق camelCase، على سبيل المثال: _myPrivateField، _customerAge.
  • UPPER_CASE: تُستخدم للثوابت. جميع الحروف كبيرة، والكلمات مفصولة بشرطات سفلية، على سبيل المثال، MAX_VALUE، PI، DEFAULT_TIMEOUT.

إليك بعض النصائح الإضافية:

  • استخدم أسماءً وصفية تشير بوضوح إلى الغرض من المتغير أو الطريقة (method).
  • تجنب الاختصارات أو الأوائلية ما لم تكن مفهومة على نطاق واسع في سياق الكود الخاص بك.
  • كن متسقاً مع الاصطلاحات التي اخترتها طوال مشروعك.

ورقة مرجعية

تساعد اصطلاحات التسمية في C# على إبقاء الكود منظماً وقابلاً للصيانة:

  • PascalCase: لأسماء الفئات (classes)، وأسماء الدوال (methods)، وأسماء الخصائص (properties)
    MyClass, CalculateTotal, FirstName
  • camelCase: للمتغيرات المحلية ومعاملات الدوال (parameters)
    myVariable, customerName, calculateTotal
  • _underscorePrefix: للحقول الخاصة (private fields) (شرطة سفلية + camelCase)
    _myPrivateField, _customerAge
  • UPPER_CASE: للثوابت (أحرف كبيرة مع شرطات سفلية)
    MAX_VALUE, PI, DEFAULT_TIMEOUT

نصائح إضافية:

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

جرّب بنفسك

لا يتضمّن هذا الدرس تحدّيًا برمجيًا.

quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس Fundamentals