قابلية الصيانة أمر بالغ الأهمية: درس قاسٍ من عملية تصحيح الأخطاء

حاولت أن أكون ذكياً أكثر من اللازم في الكود الخاص بي اليوم.

كتبت كوداً مختصراً. بدا نظيفاً على الشاشة. وعمل بشكل جيد خلال الاختبار الأول.

ثم ظهرت الأخطاء.

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

علمني هذا درساً حيوياً.

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

اتبع هذه القواعد لكتابة كود أفضل:

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

الكود البسيط يوفر الوقت. الكود البسيط يمنع الإحباط. إنه يبني أساساً قوياً لمشروعك القادم.

توقف عن محاولة الظهور بمظهر الذكي. ابدأ في محاولة أن تكون واضحاً.

المصدر: https://dev.to/chris_lee_5e58cce05f5d01d/maintainability-matters-a-hard-lesson-from-debugging-15kf