ابدأ التجربة المجانية
رائج جديد التصنيفات المؤلفون
EnglishEnglish
EspañolSpanish
简体中文Chinese
繁體中文Chinese (Traditional)
FrançaisFrench
DeutschGerman
日本語Japanese
PortuguêsPortuguese
ItalianoItalian
한국어Korean
РусскийRussian
NederlandsDutch
العربيةArabic
PolskiPolish
हिन्दीHindi
Tiếng ViệtVietnamese
SvenskaSwedish
ΕλληνικάGreek
TürkçeTurkish
ไทยThai
ČeštinaCzech
RomânăRomanian
MagyarHungarian
УкраїнськаUkrainian
IndonesiaIndonesian
DanskDanish
SuomiFinnish
БългарскиBulgarian
עבריתHebrew
NorskNorwegian
HrvatskiCroatian
CatalàCatalan
SlovenčinaSlovak
LietuviųLithuanian
SlovenščinaSlovenian
СрпскиSerbian
EestiEstonian
LatviešuLatvian
فارسیPersian
മലയാളംMalayalam
தமிழ்Tamil
اردوUrdu
جارٍ البحث...
SoBrief
الكود النظيف

الكود النظيف

العنوان الأصلي: Clean Code
دليل حرفية البرمجيات الرشيقة
بقلم روبرت سي. مارتن 2007 464 صفحة
4.35
٢٣٬٠٠٠+ تقييم
Amazon Kindle Audible
جرّب الوصول الكامل لمدة 3 أيام
افتح الاستماع والمزيد!
متابعة

أهم النقاط

1. الشيفرة النظيفة يجب أن تكون قابلة للقراءة، بسيطة، ومعبرة

الشيفرة النظيفة تبدو دائمًا كما لو كتبها شخص يهتم حقًا.

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

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

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

2. الأسماء المعبرة تعزز وضوح الشيفرة وسهولة صيانتها

يجب أن يجيب اسم المتغير أو الدالة أو الفئة على كل الأسئلة المهمة: لماذا وُجد؟ ماذا يفعل؟ وكيف يُستخدم؟

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

استخدم قواعد التسمية بشكل متسق. اعتمد وطبق قواعد التسمية القياسية للغة البرمجة والفريق الذي تعمل معه، مثل:

  • CamelCase لأسماء الفئات (مثلاً: CustomerOrder)
  • camelCase لأسماء المتغيرات والدوال (مثلاً: totalAmount)
  • ALL_CAPS للثوابت (مثلاً: MAX_SIZE)

تجنب الأسماء المضللة أو الزائدة. لا تستخدم أسماء قد تثير اللبس أو الخلط. مثلاً، لا تضع كلمة "list" في اسم متغير إذا لم يكن فعلاً قائمة. كذلك، تجنب الكلمات الزائدة أو عديمة الفائدة مثل "data" أو "info" إذا لم تضف معنى.

3. يجب أن تكون الدوال صغيرة، تقوم بمهمة واحدة، وتعمل على مستوى تجريد واحد

يجب أن تقوم الدوال بمهمة واحدة فقط، وأن تقوم بها بشكل جيد، ولا شيء أكثر.

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

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

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

4. يجب أن تكون التعليقات قليلة وضرورية حقًا

الاستخدام الصحيح للتعليقات هو تعويض عن فشلنا في التعبير عن أنفسنا بالشيفرة.

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

استخدم التعليقات بحكمة. التعليقات الجيدة تشرح لماذا تم فعل شيء ما، وليس كيف تم فعله. يجب أن توفر سياقًا أو توضيحًا لا يمكن التعبير عنه بالشيفرة وحدها. من أنواع التعليقات المفيدة:

  • تعليقات قانونية (حقوق النشر، الترخيص)
  • شرح النية أو الخوارزميات
  • تحذيرات من العواقب
  • تعليقات TODO (تستخدم باعتدال)

تجنب التعليقات الزائدة أو المضللة. لا تكتب تعليقات تعيد ما تقوله الشيفرة بوضوح. التعليقات القديمة أو غير الصحيحة أسوأ من عدم وجود تعليقات، لأنها قد تضلل القارئ. راجع التعليقات بانتظام وحدثها مع الشيفرة التي تصفها.

5. التنسيق الصحيح يحسن من قابلية قراءة الشيفرة

تنسيق الشيفرة هو وسيلة للتواصل، والتواصل هو أولى مهام المطور المحترف.

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

  • التراجع (Indentation)
  • فواصل الأسطر
  • مواضع الأقواس
  • المسافات حول العوامل والكلمات المفتاحية

التنسيق العمودي. نظم الشيفرة عموديًا لتعزيز الوضوح:

  • اجمع المفاهيم المرتبطة معًا
  • فصل المفاهيم غير المرتبطة
  • أعلن المتغيرات بالقرب من مكان استخدامها
  • ضع الدوال المعتمدة بجانب بعضها

التنسيق الأفقي. اجعل الأسطر قصيرة نسبيًا (عادة بين 80-120 حرفًا) لتجنب الحاجة للتمرير الأفقي. قسم العبارات الطويلة إلى عدة أسطر بطريقة منطقية. استخدم المساحات البيضاء لفصل الكتل المنطقية داخل السطر.

6. الكائنات وهياكل البيانات تخدم أغراضًا مختلفة

الكائنات تخفي بياناتها خلف التجريدات وتعرض دوالًا تعمل على تلك البيانات. هياكل البيانات تعرض بياناتها ولا تحتوي على دوال ذات معنى.

الكائنات مقابل هياكل البيانات. الكائنات تغلف البيانات وتعرض السلوك من خلال الطرق (methods). هي مناسبة لإضافة أنواع جديدة (فئات) دون تغيير السلوك القائم. أما هياكل البيانات، فهي تعرض البيانات ولا تحتوي على سلوكيات مهمة. هي مناسبة لإضافة سلوكيات جديدة دون تغيير أنواع البيانات.

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

قانون ديميتير. بالنسبة للكائنات، اتبع قانون ديميتير: يجب أن تستدعي الطريقة فقط طرقًا على:

  • الكائن نفسه
  • معطياته
  • أي كائنات ينشئها
  • مكوناته المباشرة
    هذا المبدأ يساعد في تقليل الترابط بين أجزاء النظام المختلفة.

7. التعامل مع الأخطاء يجب أن يكون نظيفًا ومفيدًا

التعامل مع الأخطاء مهم، لكن إذا كان يعيق وضوح المنطق فهو خاطئ.

استخدم الاستثناءات بدلًا من رموز الخطأ. الاستثناءات توفر طريقة أنظف للتعامل مع الأخطاء مقارنة برموز الخطأ التقليدية. تفصل منطق التعامل مع الأخطاء عن الشيفرة الرئيسية، مما يجعل كلاهما أسهل في الفهم والصيانة.

أنشئ رسائل خطأ مفيدة. يجب أن توفر رسائل الخطأ سياقًا كافيًا لفهم ما حدث وأين. أدرج تفاصيل مثل:

  • العملية التي كانت تُجرى
  • الخطأ المحدد الذي وقع
  • أي قيم أو حالة ذات صلة

اكتب عبارات try-catch-finally أولًا. عند كتابة شيفرة قد ترمي استثناءات، ابدأ بكتابة كتل try-catch-finally. هذا يساعد على ضمان أن الشيفرة مقاومة للأخطاء من البداية وأن حالات الخطأ مدروسة بشكل صحيح.

8. اختبارات الوحدة ضرورية للحفاظ على الشيفرة النظيفة

شيفرة الاختبار لا تقل أهمية عن شيفرة الإنتاج.

اكتب الاختبارات أولًا. اتبع ممارسة تطوير البرمجيات المعتمدة على الاختبار (TDD):

  1. اكتب اختبارًا يفشل
  2. اكتب أقل شيفرة لتمرير الاختبار
  3. أعد هيكلة الشيفرة مع الحفاظ على نجاح الاختبار
    هذا النهج يضمن أن شيفرتك قابلة للاختبار من البداية ويساعد في دفع التصميم الجيد.

حافظ على نظافة الاختبارات. طبق نفس معايير النظافة على شيفرة الاختبار كما تفعل مع شيفرة الإنتاج. يجب أن تكون الاختبارات:

  • قابلة للقراءة
  • سهلة الصيانة
  • موثوقة

اتبع مبادئ F.I.R.S.T للاختبارات:

  • سريعة: يجب أن تنفذ بسرعة
  • مستقلة: لا تعتمد على بعضها البعض
  • قابلة للتكرار: يمكن تشغيلها في أي بيئة
  • ذات تحقق ذاتي: تعطي نتيجة صحيحة أو خاطئة
  • في الوقت المناسب: تكتب قبل شيفرة الإنتاج مباشرة

9. يجب أن تكون الفئات صغيرة، مركزة، وتتبع مبدأ المسؤولية الواحدة

القاعدة الأولى للفئات أنها يجب أن تكون صغيرة. القاعدة الثانية أنها يجب أن تكون أصغر من ذلك.

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

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

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

10. البرمجة المتزامنة تتطلب تصميمًا وتنفيذًا دقيقين

كتابة برامج متزامنة نظيفة أمر صعب—صعب جدًا.

افهم تحديات التزامن. البرمجة المتزامنة تقدم تعقيدات مثل:

  • حالات السباق
  • الجمود (Deadlocks)
  • مشاكل الحيّوية (Liveness)
  • تأثيرات الأداء

فصل الشيفرة المتعلقة بالتزامن. عزل الشيفرة التي تتعامل مع التزامن يجعل من الأسهل التفكير فيها، اختبارها، وصيانتها، سواء للأجزاء المتزامنة أو غير المتزامنة من النظام.

استخدم المكتبات والأُطُر الموجودة. استعن بمكتبات وأُطُر التزامن المجربة (مثل java.util.concurrent في جافا) بدلًا من محاولة تنفيذ التحكم بالتزامن منخفض المستوى بنفسك. هذه الأدوات مُحسنة ومختبرة جيدًا لأنماط التزامن الشائعة.

اكتب اختبارات شاملة. اختبار الشيفرة المتزامنة تحدٍ لكنه ضروري. اكتب اختبارات:

  • تنشئ عدة خيوط (Threads)
  • تغير التوقيت والجدولة
  • تُشغل مرات عديدة لزيادة فرصة كشف المشاكل المتقطعة
  • تستخدم أدوات مثل منظفات الخيوط والمحللات الثابتة للمساعدة في تحديد الأخطاء المحتملة في التزامن

آخر تحديث:

الإبلاغ عن مشكلة

ملخص المراجعات

4.35 من 5
متوسط ٢٣٬٠٠٠+ تقييمات من Goodreads وAmazon.

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

تقييمك:
4.63
516 تقييم
هل تريد قراءة الكتاب كاملًا؟

عن المؤلف

روبرت سيسيل مارتن، المعروف بلقب "العم بوب"، هو مهندس برمجيات بارز ومدافع قوي عن منهجيات التطوير الرشيق (Agile). يشغل مارتن منصب رئيس شركة Object Mentor Inc.، حيث يقود فريقًا من المستشارين المتخصصين في التصميم الموجه للكائنات، وأنماط البرمجة، وUML، وممارسات التطوير الرشيق. يمتد خبرته إلى عدة لغات برمجة ومنهجيات، منها لغة C++ وبرمجة eXtreme. كما شغل منصب رئيس تحرير مجلة C++ Report، ويُعد من المتحدثين المطلوبين في المؤتمرات الدولية. تأثير مارتن في مجتمع تطوير البرمجيات كبير، حيث شكلت تعاليمه وكتبه معايير الممارسات الفضلى لكتابة الشيفرة النظيفة والحرفية المهنية في صناعة البرمجيات.

تحميل PDF

لحفظ ملخص الكود النظيف لوقت لاحق، نزّل ملف PDF المجاني. يمكنك طباعته أو قراءته دون اتصال بالإنترنت في الوقت الذي يناسبك.
Download PDF

تحميل EPUB

لقراءة ملخص الكود النظيف على جهاز أو تطبيق القراءة الإلكترونية، نزّل ملف EPUB المجاني. صيغة الكتب الرقمية .epub مثالية لقراءة الكتب الإلكترونية على الهواتف والأجهزة اللوحية وأجهزة القراءة الإلكترونية.
Download EPUB
هل تريد قراءة الكتاب كاملًا؟
متابعة
استمع
الرئيسية
Swipe
مكتبتي
التطبيق
جرّب الوصول الكامل لمدة 3 أيام
استمع، أضف إشارة مرجعية، والمزيد
قارن الميزات مجاني Pro
📖 اقرأ الملخصات
اقرأ ملخصات غير محدودة. المستخدمون المجانيون يحصلون على 3 شهرياً
🎧 استمع إلى الملخصات
استمع إلى ملخصات غير محدودة بـ 40 لغة
—
❤️ إشارات مرجعية غير محدودة
المستخدمون المجانيون مقيدون بـ 4
—
📜 سجل غير محدود
المستخدمون المجانيون مقيدون بـ 4
—
📥 تحميلات غير محدودة
المستخدمون المجانيون مقيدون بـ 1
—
جدول زمني بدون مخاطر
اليوم: احصل على وصول فوري
استمع إلى ملخصات كاملة لأكثر من 26,000 كتاب. أي أكثر من 12,000 ساعة صوتية!
اليوم الثاني: تذكير بالتجربة
سنرسل لك إشعارًا بأن فترة التجربة على وشك الانتهاء.
اليوم الثالث: يبدأ اشتراكك
سيتم الخصم في ٢٤ نوفمبر,
يمكنك الإلغاء في أي وقت قبل ذلك.
Consume 2.8× More Books
2.8× كتب إضافية الاستماع القراءة
مستخدمونا يحبوننا
1M+ قارئ
Trustpilot Rating
TrustPilot
4.6 ممتاز
هذا الموقع غيّر قواعد اللعبة تمامًا. لقد أنهيت ملخصات الكتب بسرعة لم أعهدها من قبل. أنصح به بشدة.
— Dave G
يستحق المال والوقت، وصُنع بإتقان. لم أرَ هذه الجودة في الملخصات على مواقع أخرى. مفيد جدًا!
— Em
أنصح به بشدة!! خدمة رائعة. مثالي لمن يريد أكثر من مجرد لمحة ولكن ليس كل التفاصيل الدقيقة للكتاب الصوتي الكامل.
— Greg M
وفّر 62%
سنوي
$119.88 $44.99/سنة/سنة
$3.75/شهر
شهري
$9.99/شهر
ابدأ تجربة مجانية لمدة 3 أيام
3 أيام مجاناً، ثم $44.99/سنة. إلغاء في أي وقت.
Unlock a world of fiction & nonfiction books
أكثر من 26,000 كتاب بسعر كتابين
اقرأ أي كتاب في 10 دقائق
اكتشف كتبًا جديدة بأسلوب Tinder
اطلب أي كتاب إذا لم يكن ملخصًا
اقرأ كتبًا أكثر من أي شخص تعرفه
التطبيق الأول لعشاق الكتب
Lifelike & immersive summaries
ضمان استرداد الأموال خلال 30 يومًا
حمّل الملخصات بصيغة EPUB أو PDF
ألغِ في أي وقت بنقرات قليلة

لماذا ملخص واحد فقط؟

الماسح الضوئي
ابحث عن باركود لمسحه

⭐
⭐
⭐
لدينا هدية مميزة لك
فتح
خصم 38٪
خصم لك
⭐
⭐
⭐
$79.99
$49.99/سنة
فقط $4.16 شهريًا
متابعة
ضغطة واحدة للبدء، وإلغاء سهل جدًا
الإعدادات
عام
الأداة
جارٍ التحميل...