التعليقات في جافا

التعليق يجعل الكود مفهومًا لمن يقرؤه بعدك

public class Mystery {
    public static void main(String[] args) {
        double a = 4.5;
        double b = 2;
        System.out.println(a * b / 2);
    }
}

4.5

public class Triangle {
    public static void main(String[] args) {
        // area of a triangle
        double a = 4.5; // base
        double b = 2;   // height
        System.out.println(a * b / 2);
    }
}

4.5

التعليق لا يغيّر عمل البرنامج: الكودان يطبعان 4.5، لكن الثاني أسرع فهمًا.

التعليق ملاحظة داخل الكود يتجاهلها المترجم

التعليق نص نكتبه داخل البرنامج لنشرح ما يفعله الكود. المترجم لا يترجمه ولا ينفّذه، ويتجاهل كل حرف داخله مهما كان مكتوبًا فيه.

// comment

/* comment */

/** comment */

public class Ignored {
    public static void main(String[] args) {
        // System.out.println("Hidden"); @#$ 123 nonsense
        System.out.println("Shown");
    }
}

Hidden
Shown

Shown

Error

Shown

التعليق يشرح الكود، ويذكّرك بفكرتك، ويوقف سطرًا مؤقتًا

التعليق للبشر فقط: البرنامج يعمل بالطريقة نفسها مع التعليقات وبدونها.

public class Pause {
    public static void main(String[] args) {
        System.out.println("One");
        System.out.println("Two");
        System.out.println("Three");
    }
}

One
Three

public class Pause {
    public static void main(String[] args) {
        System.out.println("One");
        // System.out.println("Two");
        System.out.println("Three");
    }
}

التعليقات تبقى في الكود عالي المستوى، ولا تصل إلى لغة الآلة

تذكير: يمر برنامجك بثلاثة مستويات قبل أن ينفّذه المعالج.

المترجم يحذف التعليقات أثناء الترجمة، فلا تصل إلى ملف .class، ولذلك لا تؤثر في سرعة البرنامج ولا في حجمه بعد الترجمة.

تعليق السطر الواحد يبدأ بـ // ويتوقف عند نهاية السطر

1. اكتب الكود وشغّلهفي المختبر اضغط F6، وهنا زر «تشغيل» أو Ctrl+Enter.
2. توقّع: هل يظهر التعليق في الناتج؟
3. احذف // من السطر الثالث وشغّل
4. فسّر رسالة الخطأ، ثم أعد //

public class Comments {
    public static void main(String[] args) {
        // print a welcome message
        System.out.println("Welcome");
        int x = 5; // comment after code
        System.out.println(x);
    }
}

Welcome
5

public class Comments {
    public static void main(String[] args) {
        print a welcome message
        System.out.println("Welcome");
        int x = 5; // comment after code
        System.out.println(x);
    }
}

public class Comments {
    public static void main(String[] args) {
        // print a welcome message
        System.out.println("Welcome");
        int x = 5; // comment after code
        System.out.println(x);
    }
}

Welcome
5

تعليق الأسطر المتعددة يشرح فقرة كاملة أو يوقف عدة أسطر

• /* يفتح التعليق و*/ يغلقه، وكل ما بين الرمزين تعليق مهما كان عدد الأسطر.
• نستخدمه عندما يطول الشرح ولا يكفيه سطر واحد.
• يفيد في إيقاف عدة أسطر من الكود دفعة واحدة.
• إذا نسيت الإغلاق صار باقي الملف تعليقًا.

/* Program: Counting
   Author: Sara Ali
   Date: 2026-09-01 */
public class Counting {
    public static void main(String[] args) {
        System.out.println("One");
        /* System.out.println("Two"); */
        System.out.println("Three");
    }
}

One
Three

public class Middle {
    public static void main(String[] args) {
        System.out.println("A"); /* System.out.println("B");
        System.out.println("C"); */ System.out.println("D");
    }
}

A
D

A
B
C
D

A
C
D

D

A
D

تعليق التوثيق يصف البرنامج بوسوم تقرؤها أداة javadoc

أداة javadoc تقرأ هذه الأسطر وتنشئ منها صفحات توثيق، مثل صفحات توثيق Java الرسمية.

/**
 * Prints "Hello World!"
 *
 * @author Ahmed Ali
 * @version 1.0
 * @since 2020-09-25
 */
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}

Hello World!

في NetBeans نكتب تعليق التوثيق وننشئ صفحاته بأمر واحد

1. افتح الملف HelloWorld.javaمن شجرة المشروع في منطقة Projects.
2. اكتب /** فوق الصنف ثم اضغط Enterيكمل NetBeans هيكل التعليق. أكمل الوصف والوسوم.
3. اختر Run > Generate Javadocتظهر النتيجة في نافذة Output، وتُفتح الصفحات في المتصفح.

Output - HelloWorld (javadoc)
javadoc:
Generating Javadoc...
BUILD SUCCESSFUL (total time: 2 seconds)

ثلاثة أنواع من التعليقات، ولكل نوع استخدام

المترجم يتجاهل الأنواع الثلاثة. الفرق بينها في الشكل، وفي من يقرأ التعليق؛ فتعليق التوثيق وحده تقرؤه أداة javadoc لتصنع منه صفحات توثيق.

الرمز // داخل علامات التنصيص نص يُطبع، وليس تعليقًا

public class CommentFirst {
    public static void main(String[] args) {
        // System.out.println("Hi");
        System.out.println("Done");
    }
}

Hi
Done

// Hi
Done

Done

Done

public class InQuotes {
    public static void main(String[] args) {
        System.out.println("// Hi");
    }
}

Hi

// Hi

Error

// Hi

تعليق الأسطر المتعددة بلا إغلاق يحوّل باقي الملف إلى تعليق

public class Unclosed {
    public static void main(String[] args) {
        /* print a welcome message
        System.out.println("Welcome");
    }
}

public class Unclosed {
    public static void main(String[] args) {
        /* print a welcome message */
        System.out.println("Welcome");
    }
}

Welcome

public class Nested {
    public static void main(String[] args) {
        /* outer comment
           /* inner comment */
           this line is outside the comment */
        System.out.println("Welcome");
    }
}

public class Nested {
    public static void main(String[] args) {
        /* outer comment
           /* inner comment
           this line is inside the comment */
        System.out.println("Welcome");
    }
}

Welcome

التعليق الجيد يشرح سبب الكود، ولا يكرر ما يقوله

رموز الهروب تبدأ بشرطة مائلة عكسية، وتطبع ما لا نكتبه مباشرة

كيف نطبع سطرًا جديدًا ومسافة جدولة وعلامة تنصيص داخل النص؟ بوضع رمز هروب داخل علامتي التنصيص.

public class Escapes {
    public static void main(String[] args) {
        System.out.println("Ali\nSara");
        System.out.println("Ali\tSara");
        System.out.println("C:\\Java");
        System.out.println("\"Hi\"");
    }
}

Ali
Sara
Ali	Sara
C:\Java
"Hi"

• رموز تحتاجها في هذه المحاضرة: حوّل لغة الكتابة إلى الإنجليزية قبل كتابة الكود (Alt+Shift).
• الشرطة المائلة العكسية \: المفتاح فوق Enter، وبها تبدأ رموز الهروب.
• الشرطة المائلة /: المفتاح المجاور لـ Shift الأيمن.
• النجمة *: Shift مع الرقم 8.
• علامة التنصيص ": Shift مع المفتاح المجاور لـ Enter.

الدالة print لا تنتقل إلى سطر جديد، و\" لا تغلق النص

public class PrintNewLine {
    public static void main(String[] args) {
        System.out.print("Hi\n");
        System.out.print("Hello ");
        System.out.println("Java");
    }
}

Hi
Hello Java

public class Quote {
    public static void main(String[] args) {
        System.out.println("Hi\");
    }
}

public class Quote {
    public static void main(String[] args) {
        System.out.println("Hi");
    }
}

Hi

public class PathTitle {
    public static void main(String[] args) {
        // Print the two lines here

    }
}

C:\Users\Sara
The book "Java"

public class PathTitle {
    public static void main(String[] args) {
        System.out.println("C:\\Users\\Sara");
        System.out.println("The book \"Java\"");
    }
}

تمرين ختامي: وثّق برنامجك واطبع بطاقة تعريف

• تعليق توثيق فيه اسمك ورقم إصدار البرنامج.
• تعليق سطر واحد فوق كل أمر طباعة، يشرح ما يطبعه.
• رموز هروب: مسافة جدولة وعلامتا تنصيص.

/**
 * Prints a student ID card.
 *
 * @author Your Name
 * @version 1.0
 */
public class Comments {
    public static void main(String[] args) {
        // Write one comment and one print statement for each line

    }
}

Name:	Ahmed
Course: "Programming 1"
Version: 1.0

/**
 * Prints a student ID card.
 *
 * @author Ahmed Ali
 * @version 1.0
 */
public class Comments {
    public static void main(String[] args) {
        // the student's name, after a tab
        System.out.println("Name:\tAhmed");
        // the course name, in quotation marks
        System.out.println("Course: \"Programming 1\"");
        // the program version
        System.out.println("Version: 1.0");
    }
}

أسئلة المراجعة

/* start of program

public class Review {
    public static void main(String[] args) {
        System.out.println("A\tB");
        System.out.println("// A");
    }
}

A	B
// A

A\tB
// A

A	B

A
B
A

A	B
// A