En Java los comentarios son textos que el compilador ignora. Sirven para explicar partes del código y hacerlo más fácil de entender. Existen tres formas principales de escribir comentarios.
1. Comentarios de una sola línea
Se escriben con //. Todo lo que esté después en la misma línea será ignorado.
public class Comentarios {
public static void main(String[] args) {
// Este es un comentario de una sola línea
System.out.println("Hola Shayla");
}
}
2. Comentarios de varias líneas
Se escriben entre /* ... */. Permiten comentar varias líneas seguidas.
public class Comentarios {
public static void main(String[] args) {
/* Esto es un comentario
que ocupa varias líneas */
System.out.println("Aprendiendo Java");
}
}
3. Comentarios de documentación (mención breve)
También existen los comentarios de documentación, que se escriben con /** ... */. Estos se usan para generar documentación automática del código, aunque aquí solo haremos un ejemplo breve porque se explicarán mejor en otra entrada.
/**
* Clase de ejemplo con un comentario de documentación
*/
public class Comentarios {
public static void main(String[] args) {
System.out.println("Ejemplo con documentación");
}
}
Conclusión
//→ para comentar una sola línea./* ... */→ para comentar varias líneas./** ... */→ para documentación automática (se explicará en otra entrada).
Los comentarios son muy útiles para recordar qué hace tu código y para que otras personas lo entiendan mejor.