Averigüemos qué son los comentarios y por qué son importantes en programación.

También cubrimos dos tipos comunes de comentarios y cómo escribirlos en 15 lenguajes de programación diferentes.

¿Qué son los comentarios en programación?

Los comentarios, en términos sencillos, son trozos de texto que no serán visibles para los usuarios finales y que sirven de referencia a las personas que están escribiendo código.

Un poco más formalmente, un comentario es una descripción de un programa sobre su funcionamiento en un formato sencillo de leer. Suelen utilizarse en lugares en los que es necesario proporcionar cierta claridad adicional al desarrollador que está leyendo el código. Por lo tanto, esto ayuda a mejorar la legibilidad del código y reduce el tiempo y la comunicación que serían necesarios para transferir conocimientos.

El compilador/intérprete simplemente ignora los comentarios en su código, por lo que no afectan a la salida final de su programa. Así que, en pocas palabras, los comentarios son como una explicación sencilla y legible de ciertas partes del código.

Tipos comunes de comentarios

La mayoría de los lenguajes de programación admiten 2 tipos de comentarios.

  • Comentario de una sola línea
  • Comentario multilínea / Comentarios en bloque

Como su nombre indica los comentarios de una sola línea son útiles cuando uno necesita añadir un pequeño texto de una sola línea, por ejemplo, una condición particular, un valor constante que necesita una pequeña descripción. Mientras que los multilínea funcionan mejor cuando tenemos una mayor cantidad de información que añadir como una descripción sobre una función y cómo se puede utilizar, etc.

Existen otros tipos de comentarios, como los comentarios de documento, pero eso queda fuera del ámbito de este artículo.

¿Por qué debería añadir comentarios?

«Cualquier tonto puede escribir código que un ordenador pueda entender. Los buenos programadores escriben código que los humanos pueden entender» – Martin Fowler

La mayor ventaja de añadir comentarios es la mejora de la legibilidad y la mejor comprensión del programa. Aparte de esto, algunas otras ventajas incluyen

  • Los comentarios facilitan enormemente que sus compañeros e incluso otros desarrolladores entiendan la lógica sin necesidad de leer largas documentaciones.
  • Reducción de la comunicación entre desarrolladores por pequeñas dudas
  • Los comentarios son ignorados por el compilador/interpretador.
  • Para el software de código abierto, son imprescindibles, ya que usted no estará allí para explicar cada función a millones de desarrolladores que quieran utilizar ese programa en concreto.

Comentarios en varios idiomas

Impresionante, ahora que hemos aprendido acerca de los comentarios y por qué son útiles. Exploremos cómo podemos añadir comentarios en diferentes lenguajes de programación.

Comentarios en C/C

Comentario de una sola línea

// Este es un comentario de una sola línea en C/C 

Comentario multilínea

/* Esto es ligeramente largo
comentario multilínea en C/C */

Comentarios en Python

Comentario de una sola línea

# Este es un comentario de una sola línea en Python

Comentario multilínea

# Esto es ligeramente largo
# comentario multilínea en Python

Comentarios en Java

Comentario de una sola línea

// Este es un comentario de una sola línea en Java

Comentario multilínea

/* Esto es ligeramente largo
comentario multilínea en Java */

Comentarios en Ruby

Comentario de una sola línea

# Esto es un comentario de una sola línea en Ruby

Comentario multilínea

=comienzo 
Este es un comentario
comentario multilínea en Ruby
=fin

Comentarios en Golang

Comentario de una sola línea

// Este es un comentario de una sola línea en Golang

Comentario multilínea

/* Este es un comentario
comentario multilínea en Golang */

Comentarios en Haskell

Comentario de una sola línea

- Este es un comentario de una sola línea en Haskell

Comentario multilínea

{- Este es un comentario
comentario multilínea en Haskell -}

Comentarios en Rust

Comentario de una sola línea

// Este es un comentario de una sola línea en Rust

Comentario multilínea

/* Esto es ligeramente largo
comentario multilínea en Rust */

Comentarios en HTML

Comentario de una sola línea


Comentario multilínea


Comentarios en CSS

Comentario de una sola línea

/* Este es un comentario de una sola línea en CSS */

Comentario multilínea

/* Este es un comentario
comentario multilínea en CSS */

Comentarios en JavaScript

Comentario de una sola línea

// Este es un comentario de una sola línea en Javascript

Comentario multilínea

/* Este es un comentario
comentario multilínea en Javascript */

Comentarios en R

Comentario de una sola línea

# Este es un comentario de una sola línea en el lenguaje de programación R

Comentario multilínea

R no admite comentarios multilínea.

Comentarios en Erlang

Comentario de una sola línea

% Esto es un comentario de una sola línea en Erlang

Comentario multilínea

R no soporta comentarios multilínea.

Comentarios en PHP

Comentario de una sola línea

// Este es un comentario de una sola línea en PHP

Comentario multilínea

/* Este es un comentario
comentario multi-línea en PHP */

Comentarios en Perl

Comentario de una sola línea

# Este es un comentario de una sola línea en Perl

Comentario multilínea

=comienzo 
Este es un comentario
comentario multilínea en Perl
=fin

Comentarios en Kotlin

Comentario de una sola línea

// Este es un comentario de una sola línea en Kotlin

Comentario multilínea

/* Este es un comentario
comentario multilínea en Kotlin */

Conclusión

El tutorial cubrió lo básico sobre los comentarios y 2 tipos comunes – Single y Multi-line. También traté de cubrir por qué son útiles los comentarios y uno debe escribirlos cuando sea necesario. ¡Espero que haya aprendido algo nuevo!

Siga explorando. ¡Siga aprendiendo! 👨‍💻