Páginas

Cómo escribir comentarios en JAVA

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.