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