Comentarios

¿Qué es un comentario? Se podría decir que son fragmentos de código que el programa va ignorar y no se van a ejecutar. ¿Y para qué sirven? Nos sirven para dejar notas a nosotros mismos o a otros programadores para guiarnos en el código.

Aquí vamos a ver tres tipos de comentarios:

• Comentarios de una línea comienzan con doble diagonal inversa \\
• Comentarios de múltiples líneas comienzan con \* y terminan con *\
• Comentarios de documentación comienzan con triple diagonal inversa \\\

En el siguiente código podemos ver el uso de cada uno de los comentarios y nos damos cuenta que al ejecutar el código no afectan en nada el resultado de la consola:

En la siguiente imagen podemos ver que si escribimos la palabra TODO podremos ver el comentario en el campo de información de DartPad. Algunos IDES como Android Studio y Visual Studio también tienen soporte para la palabra TODO en los comentarios:

Comentario TODO

Los comentarios de documentación se muestran en el campo de documentación de nuestro IDE cuando seleccionamos el objeto o la función. Ver imagen:

Comentario de documentación