AD

¿Ya dominas lo básico? Un curso estructurado de Java es la vía rápida para dar el salto.

Ver cursos de Java en Udemy

Enlace de afiliado. No te cuesta nada extra.

Lecciones de Java
Lección 17 / 68

Escribir comentarios

En esta lección dejarás notas en el código para quien lo lea después.

Java tiene tres formas: // para una línea, /* ... */ para varias, y /** ... */ para Javadoc, la documentación oficial de una clase o método.

El código de ejemplo muestra las tres junto a código real.

Javadoc es lo que distingue a Java: con @param, @return y @throws se genera documentación navegable, y el editor la muestra al pasar el ratón por encima. Toda la documentación de la biblioteca estándar está escrita así.

Sobre qué escribir: un comentario que repite lo que dice la línea sobra y envejece mal. El valioso explica por qué — qué alternativa se descartó, qué requisito obligó a esa solución. Eso es justo lo que no se puede deducir leyendo el código.

📖 Código de referencia
✍️ Tu código
Escribe tu código y pulsa «Ejecutar»

🧪 Este sitio no puede compilar ni ejecutar Java directamente, así que comprueba al instante si lo que escribiste coincide con el código de referencia (la corrección ocurre por completo en tu navegador; no se envía nada a ningún servidor).

🔗 El mismo tema en otros lenguajes

Mira cómo se escribe lo mismo en otro lenguaje.

Espacio publicitario (banner)
Espacio publicitario (en el artículo)