التعليقات في Java أسطر يكتبها المطور لتوضيح الكود ولا يقوم المُترجم بمعالجتها. تساعد على شرح الأجزاء المعقدة وتوثيق الأكواد للمطورين الآخرين أو لنفس المبرمج عند مراجعة الكود لاحقًا.
التعليق على سطر واحد
// هذا تعليق على سطر واحد
int age = 25; // تعليق في نهاية السطر
التعليق متعدد الأسطر
/*
هذا تعليق
يمتد على عدة أسطر
*/
System.out.println("اختبار");
تعليقات التوثيق Javadoc
تُستخدم تعليقات Javadoc لتوليد توثيق رسمي للكود تلقائيًا، وتبدأ بـ /** وتنتهي بـ */. تحتوي على وسوم خاصة مثل @param و@return لوصف معاملات الدالة وقيم الإرجاع.
/**
* تجمع رقمين
* @param a الرقم الأول
* @param b الرقم الثاني
* @return الناتج
*/
public int add(int a, int b) {
return a + b;
}