دليل المطوّر إلى اصطلاحات التسمية

قد تبدو طريقة تسميتك للمتغيرات والدوال والملفات مسألة ذوق، لكنها في الحقيقة قاعدة تشكّل إنتاجية فريقك وقابلية قراءة شيفرتك.

لماذا تهمّ اصطلاحات التسمية

تُقرأ الشيفرة أكثر بكثير مما تُكتب. واصطلاح التسمية المتسق يساعد الآخرين، ونفسك في المستقبل، على فهم الشيفرة بسرعة.

عندما تكون القواعد موحّدة، يلمّح الاسم وحده إلى ما إذا كان الشيء متغيرًا أو ثابتًا أو فئة، مما يقلّل من البحث المهدور.

التنسيقات الرئيسية في لمحة

• camelCase — الكلمة الأولى بأحرف صغيرة، والحرف الأول من الكلمات التالية كبير (myVariableName)
• PascalCase — الحرف الأول من كل كلمة كبير (MyClassName)
• snake_case — كل الأحرف صغيرة، والكلمات موصولة بشرطات سفلية (my_variable_name)
• CONSTANT_CASE — كل الأحرف كبيرة مع شرطات سفلية، عادةً للثوابت (MAX_COUNT)
• kebab-case — كل الأحرف صغيرة مع شرطات، عادةً لعناوين URL وCSS (my-class-name)

الاصطلاحات بحسب اللغة والسياق

توصي لغات كثيرة باصطلاحاتها الخاصة. تفضّل Python استخدام snake_case للمتغيرات والدوال، وتستخدم JavaScript وJava صيغة camelCase، وتستخدم معظم اللغات PascalCase لأسماء الفئات.

تُكتب الثوابت غالبًا بصيغة CONSTANT_CASE بصرف النظر عن اللغة، وتُعدّ kebab-case عمليًا المعيار لمسارات URL وفئات CSS.

الاتساق أهم من القاعدة

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

عند الانضمام إلى قاعدة شيفرة قائمة، فضّل اصطلاحاتها على ذوقك الشخصي. وإذا احتجت إلى إعادة تسمية معرّفات كثيرة دفعة واحدة، فإن محوّل حالة الأحرف يساعدك.