Saltar a contenido

Conclusiones finales sobre comentarios

Los comentarios son una parte crucial de un programa. De ahí que sea fundamental aprender a escribir buenos comentarios.

Definición

Un comentario es el equivalente de una nota o recordatorio conformado por una serie de caracteres encabezados por el símbolo hash # ("almohadilla") -en una sola línea de código- o por una cadena de caracteres delimitados por comillas simples ' o comillas dobles " -en una o varias líneas de código- que el intérprete ignorará de manera tal que no va a interferir con el resto del código, ni con la ejecución del programa, sin generar ninguna ruptura en la lógica del algoritmo.

Es importante recalcar que un comentario puede escribirse en cualquier idioma, y no necesariamente en el idioma del programa, del programador o incluso del sistema operativo donde será ejecutado el programa.

Por lo tanto, los comentarios solo están destinados para las personas comprendan el funcionamiento de un fragmento de código. La computadora simplemente ignorará el comentario.

Esto es así especialmente porque el intérprete de Python ignorará por completo los comentarios. Puedes entender esto en el siguiente ejemplo:

¡¡Para recordar!!

El uso de este caracter (#) dentro de una cadena de texto no se considera comentario.

Debes tomar conciencia de la importancia de documentar el código para que otros programadores (o incluso tu en el futuro) puedan entenderlo fácilmente.

Python
# Este comentario será ignorado por el intérprete de Python
print("Línea comentada")
Terminal (Entrada/Salida)
Línea comentada
>

La línea 1 es ignorada por el intérprete. No produce ningún efecto en el programa puesto que es omitida (no es ejecutada).

El símbolo > representa el cursor que espera una línea de comando en el Terminal del sistema operativo.