مبادئ الكود النظيف التي يجب أن يتبعها كل مطوّر
Mubaris Fahamالمؤسس، Ficavo
الكود النظيف لا يتعلق بالمظهر، بل بجعل التغيير التالي رخيصًا، لك بعد ستة أشهر ولمن يرث المشروع من بعدك.
الأسماء تؤدي معظم العمل
الدالة ذات الاسم الجيد نادرًا ما تحتاج إلى تعليق. سمِّ الأشياء بما تعنيه في العمل، لا بطريقة تنفيذها. calculateInvoiceTotal تحكي قصة، وprocessData2 تخفي واحدة.
دوال صغيرة وصادقة
يجب أن تؤدي الدالة شيئًا واحدًا وأن تفعل ما يقوله اسمها، دون آثار جانبية مفاجئة. عندما تحتاج دالة إلى فقرة لشرحها، فهي غالبًا تريد أن تكون دالتين.
اكتب الكود للقارئ. الكمبيوتر سيفهمه في كل الأحوال.
عادات تحافظ على صحة الكود
- اترك كل ملف أفضل قليلًا مما وجدته
- احذف الكود الميت بدلًا من تحويله إلى تعليقات
- اكتب اختبارات للسلوك، لا لتفاصيل التنفيذ
- اجعل طلبات الدمج صغيرة بما يكفي لمراجعتها جيدًا
- أتمِت التنسيق لتركّز المراجعات على ما يهم
لا شيء من هذا براق، لكنه الفرق بين منتج يتسارع مع الوقت ومنتج يتباطأ حتى يتوقف.