مرحبًا بك في الدرس الرابع من سلسلة أساسيات بايثون على موقع بايثون العرب. في الدرس السابق تعلمنا أن المسافات البادئة Indentation في بايثون ليست مجرد شكل للكود، بل جزء أساسي من بناء الجملة في Python.
في هذا الدرس سنتعلم مفهومًا مهمًا جدًا لكل مبتدئ، وهو التعليقات في بايثون Python Comments. التعليقات تساعدك على شرح الكود، تذكر سبب كتابة بعض الأسطر، وتعطيل جزء من الكود مؤقتًا أثناء التجربة بدون حذفه.
وإذا أردت تجربة الأكواد مباشرة بدون تثبيت أي برنامج، يمكنك استخدام محرر بايثون العرب لتطبيق الأمثلة بنفسك.
{getToc} $title={محتوى المقال}
{alertInfo} التعليقات في بايثون هي ملاحظات يكتبها المبرمج داخل الكود، لكن Python يتجاهلها أثناء التشغيل ولا ينفذها.
ما هي التعليقات في بايثون؟
التعليقات في بايثون هي نصوص توضيحية تكتب داخل ملف الكود، لكنها لا تُنفذ عند تشغيل البرنامج. الهدف منها هو مساعدة المبرمج على فهم الكود لاحقًا، أو توضيح فكرة معينة لشخص آخر يقرأ الملف.
تخيل أنك كتبت كودًا اليوم، ثم عدت إليه بعد شهر أو شهرين. بدون تعليقات، قد تنسى لماذا كتبت بعض الأسطر بهذه الطريقة. أما إذا استخدمت تعليقات واضحة، ستفهم الكود بسرعة أكبر.
لماذا نستخدم التعليقات في Python؟
استخدام التعليقات ليس مجرد إضافة شكلية، بل هو عادة مهمة في كتابة الكود النظيف. ومن أهم استخدامات التعليقات:
- شرح فكرة جزء معين من الكود.
- توضيح سبب استخدام طريقة معينة بدل طريقة أخرى.
- تعطيل سطر أو أكثر من الكود مؤقتًا أثناء التجربة.
- تقسيم الملف إلى أجزاء واضحة.
- مساعدة نفسك أو غيرك على فهم الكود لاحقًا.
{alertSuccess} التعليق الجيد لا يشرح الشيء الواضح، بل يشرح السبب أو الفكرة التي قد لا تظهر من قراءة الكود وحده.
طريقة كتابة تعليق في بايثون باستخدام علامة #
في بايثون نكتب التعليق باستخدام علامة الشباك #. كل شيء يأتي بعد هذه العلامة في نفس السطر يعتبر تعليقًا، ويتجاهله مفسر بايثون أثناء التشغيل.
# This is a simple comment
print("Hello, World!")عند تشغيل الكود السابق، ستظهر فقط الجملة:
Hello, World!
أما السطر الذي يبدأ بعلامة # فلن يتم تنفيذه، لأنه مجرد تعليق.
كتابة تعليق في نهاية السطر
يمكنك أيضًا كتابة تعليق في نهاية السطر بعد الكود. هذه الطريقة مفيدة عندما تريد توضيح ملاحظة قصيرة بجانب السطر نفسه.
print("Python rocks!") # Print a motivational message
x = 10 # Assign 10 to xلكن انتبه: لا تجعل التعليق في نهاية السطر طويلًا جدًا، لأن ذلك قد يجعل الكود مزدحمًا وصعب القراءة.
استخدام التعليقات لتعطيل الكود مؤقتًا
من الاستخدامات المهمة للتعليقات أنك تستطيع تعطيل سطر من الكود مؤقتًا بدون حذفه. هذا مفيد جدًا أثناء التجربة أو البحث عن سبب خطأ في البرنامج.
print("This line will run")
# print("This line will not run")
print("This line will also run")في المثال السابق، السطر الثاني لن يعمل لأنه أصبح تعليقًا. هذه الطريقة تساعدك على اختبار أجزاء من الكود بدون حذف الأسطر الأصلية.
{alertInfo} أثناء تصحيح الأخطاء، يمكنك تحويل سطر إلى تعليق مؤقتًا لتعرف هل هو سبب المشكلة أم لا.
التعليقات متعددة الأسطر في بايثون
في بعض الأحيان تحتاج إلى كتابة تعليق طويل يمتد على أكثر من سطر. في بايثون، الطريقة الأوضح والأكثر مباشرة هي وضع علامة # في بداية كل سطر.
# This is a long comment
# that explains why we wrote
# this part of the program.
print("Code is running!")هذه الطريقة واضحة جدًا، وتُظهر للقارئ أن هذه الأسطر كلها تعليقات.
هل يمكن استخدام Triple Quotes كتعليقات متعددة الأسطر؟
قد ترى بعض المبرمجين يستخدمون علامات الاقتباس الثلاثية مثل """ ... """ لكتابة نص طويل يشبه التعليق:
"""
This is a long text.
Some beginners use it like a multi-line comment.
Python will ignore it if it is not assigned to a variable.
"""
print("Code is running!")
هذه الطريقة قد تعمل في بعض الحالات، لكنها ليست تعليقًا حقيقيًا مثل علامة #. هي في الأصل سلسلة نصية متعددة الأسطر. لذلك للمبتدئين، الأفضل استخدام # عندما تريد كتابة تعليق واضح.
{alertWarning} استخدم علامة # للتعليقات العادية. أما علامات الاقتباس الثلاثية فاستخدمها بحذر، لأنها ليست تعليقًا حقيقيًا دائمًا.
الفرق بين التعليق الجيد والتعليق الضعيف
ليس كل تعليق مفيدًا. أحيانًا يكتب المبتدئ تعليقًا يشرح شيئًا واضحًا جدًا من الكود، وهذا لا يضيف قيمة حقيقية.
مثال على تعليق ضعيف
x = x + 1 # Add 1 to x
هذا التعليق ضعيف لأن الكود نفسه واضح. أي شخص يقرأ السطر سيفهم أنه يزيد قيمة x بمقدار واحد.
مثال على تعليق أفضل
x = x + 1 # Compensate for the offset in the first stepهذا التعليق أفضل لأنه يشرح السبب، وليس فقط ما يحدث. القاعدة المهمة هنا: حاول أن تجعل التعليق يشرح لماذا وليس فقط ماذا.
استخدام التعليقات لتقسيم الكود الطويل
عندما يصبح الملف طويلًا، يمكنك استخدام التعليقات لتقسيم الكود إلى مراحل أو أجزاء واضحة. هذا يجعل القراءة والتنقل داخل الملف أسهل.
# ================================
# Step 1: Prepare the data
# ================================
name = "Ali"
age = 20
# ================================
# Step 2: Show the result
# ================================
print(name)
print(age)هذه الطريقة مفيدة في الملفات التعليمية أو المشاريع الصغيرة، لكنها لا تغني عن تنظيم الكود بالدوال لاحقًا عندما تكبر البرامج.
أخطاء شائعة عند استخدام التعليقات في بايثون
| الخطأ | المشكلة | التصحيح |
|---|---|---|
| كتابة التعليق بدون # | بايثون سيحاول تنفيذ الكلام كأنه كود. | ابدأ التعليق بعلامة #. |
| شرح كل سطر بشكل زائد | يجعل الكود مزدحمًا ومزعجًا للقراءة. | علّق فقط عندما تكون هناك فائدة حقيقية. |
| استخدام تعليقات قديمة غير محدثة | التعليق يقول شيئًا والكود يفعل شيئًا آخر. | حدث التعليقات عند تعديل الكود. |
| استخدام Triple Quotes كتعليقات دائمًا | قد يسبب لبسًا لأنه ليس تعليقًا حقيقيًا. | استخدم # للتعليقات العادية. |
أفضل ممارسات كتابة التعليقات في Python
- اكتب تعليقًا عندما يحتاج القارئ إلى فهم السبب.
- لا تشرح الأشياء الواضحة جدًا.
- اجعل التعليق قصيرًا ومباشرًا.
- حدّث التعليق إذا عدّلت الكود.
- استخدم التعليقات مؤقتًا لتعطيل كود أثناء التجربة.
- لا تجعل التعليقات بديلًا عن كتابة كود واضح ومنظم.
{alertSuccess} الكود الجيد يشرح نفسه قدر الإمكان، والتعليق الجيد يشرح ما لا يستطيع الكود وحده توضيحه.
تمرين بسيط على التعليقات
جرّب كتابة الكود التالي، ثم قم بتشغيله:
# Print a welcome message
print("Welcome to Arab Python")
# This line is disabled for testing
# print("This will not appear")
print("Learning comments in Python")
بعدها جرّب إزالة علامة # من السطر المعطل، وشاهد الفرق في النتيجة.
روابط مفيدة من بايثون العرب
- أساسيات بايثون 3: شرح المسافات البادئة Indentation
- كتابة أول كود برمجي في بايثون
- محرر بايثون العرب لتجربة الأكواد أون لاين
- جميع دروس كورس أساسيات بايثون
الخلاصة
تعلمنا في هذا الدرس أن التعليقات في بايثون تبدأ بعلامة #، وأن Python يتجاهل كل ما يأتي بعدها في نفس السطر. كما رأينا كيف نستخدم التعليقات لشرح الكود، وتعطيل بعض الأسطر مؤقتًا، وكتابة ملاحظات تساعدنا على فهم البرنامج لاحقًا.
تذكر أن التعليقات ليست هدفًا بحد ذاتها، بل أداة تساعدك على كتابة كود أوضح. استخدمها عندما تضيف معنى حقيقيًا، ولا تستخدمها لشرح أشياء واضحة جدًا.
{alertSuccess} الخلاصة السريعة: استخدم # لكتابة تعليق في بايثون، واجعل تعليقك يشرح السبب أو الفكرة، وليس فقط تكرار ما يقوله الكود.