الدرس 3: جماليات الهيكلة

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

المسافة البادئة: التسلسل الهرمي البصري

تحدد المسافة البادئة كتل التنفيذ. عدم الاتساق هنا هو مُدمِّر رئيسي للـVibe.

• Tabs مقابل Spaces: بينما يستمر الجدل، فإن الاتساق هو قاعدة الـVibe الوحيدة. تتفق معظم الفرق الحديثة على 4 مسافات (أو مسافتين في لغات مثل JavaScript/CSS). اختر واحدة والتزم بها.

الكتل غير المحاذية

عندما تكون المسافة البادئة خاطئة، يبدو الهيكل مكسوراً، حتى لو قبله المُصرِّف.

python

إحساس سيئ

def calculate_total(items): total = 0 for item in items: total += item.price return total # عرضة للخطأ بسبب عدم المحاذاة

الاستخدام الاستراتيجي للمسافات البيضاء (العمودية والأفقية)

تعمل المسافات البيضاء كعلامات ترقيم في الكود، وتفصل الأفكار المنطقية.

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

javascript // إحساس جيد: فصل الاهتمامات داخل الدالة function authenticateUser(credentials) { // 1. Validate input structure if (!credentials || !credentials.username) { throw new Error('Invalid input'); }

// 2. Fetch user from database
const user = DB.findUser(credentials.username);
if (!user) {
    return false;
}

// 3. Compare passwords and return result
return passwordService.verify(credentials.password, user.hash);

}

2. المسافات البيضاء الأفقية: استخدم مسافات فردية حول العوامل (=, +, ==) وبعد الفواصل. تجنب المسافات غير الضرورية داخل الأقواس أو الحاصرات.

• إحساس سيئ: x=(y+z)*3;
• إحساس جيد: x = (y + z) * 3;

حدود طول السطر

قم بتقييد طول السطر (عادةً 80 أو 120 حرفاً). الأسطر الطويلة تجبر على التمرير الأفقي، مما يكسر التركيز ويدمر تدفق القراءة.