الدرس 4: تسمية الأشياء: التأثير العاطفي للمُعرِّفات الجيدة

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

إحساس المتغيرات

يجب أن تجيب المتغيرات على ماذا تحتويه و لماذا تحتويه.

أفضل الممارسات لتسمية المتغيرات

1. استخدم لغة المجال (Domain Language): إذا كنت تعمل ببيانات مالية، استخدم مصطلحات مثل assetValuation بدلاً من x.
2. تجنب التعيين الذهني: لا تستخدم الاختصارات إلا إذا كانت مقبولة عالمياً ضمن مجالك (مثل HTTP مقبول، custAcct ليس كذلك).
3. حدد الوحدات/النوع (عند الضرورة): userAgeInYears, timeoutMilliseconds.

إحساس الدوال والأساليب

يجب تسمية الدوال كأفعال أو عبارات عمل، تجيب على ماذا يفعل الكود.

مثال على تحول الـVibe

javascript // إحساس سيئ: فعل غامض function handle(a, b) { // ... }

// إحساس جيد: وضوح النية والمعاملات function processUserTransaction(userId, amount) { // ... }