التعليقات

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

في الصدفة، يبدأ التعليق بالرمز #. يتم تجاهل كل شيء بعد # في ذلك السطر:

# This is a comment
echo "Hello!"  # This also prints Hello!

عند تشغيل ما سبق، تتم طباعة Hello! فقط: تكون التعليقات غير مرئية تمامًا للصدفة.

الاستخدامات الشائعة للتعليقات:

1. شرح ما يفعله الأمر:

# Print a welcome message
echo "Welcome to the terminal!"

2. تعطيل أمر مؤقتًا:

# echo "This line is disabled"
echo "This line will execute"

3. سطر Shebang:

يُخبر تعليق خاص في أعلى برنامج نصي لـ shell النظامَ بأي shell يجب استخدامه:

#!/bin/bash
echo "This script runs with Bash"

يبدأ هذا line بـ #! (ويُسمّى shebang) متبوعًا بالمسار إلى الصَدَفة. وهو دائمًا أول line في script.

4. تعليقات TODO: وضع علامة على المهام المستقبلية:

# TODO: Add error handling here
echo "Processing files..."