Comentar código en Python es una de las primeras habilidades que necesitas dominar para escribir programas legibles, colaborativos y fáciles de mantener. Aquí aprenderás cómo usar comentarios de una línea, multilínea y cómo desactivar instrucciones temporalmente, todo con ejemplos directos del intérprete de Python.

Para qué sirven los comentarios en Python

Los comentarios cumplen tres funciones que vas a usar todo el tiempo cuando programes. No son decoración: son parte del flujo de trabajo real.

• Hacer tu código más fácil de leer para ti y para tu equipo.
• Desactivar líneas que no quieres ejecutar en un momento puntual.
• Explicar qué hace una instrucción específica para quien lea el archivo después.

Cuando escribes una línea suelta como Esta es una línea de código, Python la marca en amarillo y rojo porque interpreta que está mal escrita. Apenas le agregas el símbolo correcto al inicio, la línea se pone verde y desaparece el error.

¿Qué es un comentario en Python? Es una línea de texto que el intérprete ignora durante la ejecución. Sirve para documentar, explicar o desactivar código sin borrarlo.

Cómo hacer un comentario de una sola línea

La forma más común usa el numeral, también llamado hashtag, al inicio de la línea. Todo lo que escribas después de ese símbolo queda fuera de la ejecución.

Si creas un archivo con extensión .py y dentro pones una línea comentada seguida de un print("Hola Mundo"), al ejecutar con Run Python File la terminal solo mostrará Hola Mundo. La línea comentada no tiene ningún impacto.

También puedes comentar después de una instrucción, en la misma línea. Es un patrón muy popular para explicar qué hace ese fragmento:

python print("Hola Mundo") # imprime Hola Mundo en la terminal

Python ejecuta el print con normalidad y omite todo lo que viene después del numeral.

Cómo escribir un comentario multilínea

Cuando necesitas explicar algo más extenso, tienes dos caminos. Y los dos funcionan bien según el estilo que prefieras.

Numeral en cada línea

Pones un numeral al inicio de cada renglón. Es la forma más explícita y la que muchos equipos prefieren porque deja claro que cada línea es un comentario independiente.

python

Este es un comentario

que ocupa varias líneas

y Python lo ignora completo

Comillas triples

La otra opción son las comillas triples al inicio y al final del bloque. Todo lo que pongas en medio queda fuera de la ejecución.

python """ Este será un comentario multilínea que puede tener el largo que quieras """ print("Hola Mundo")

Al guardar y ejecutar, la terminal solo muestra Hola Mundo. El bloque entre comillas triples queda ignorado.

¿Cuál es la diferencia entre usar numeral y comillas triples? El numeral es un comentario puro y se usa línea por línea. Las comillas triples son técnicamente un string que Python no asigna a nada, por eso funcionan como comentario en bloque.

Cómo desactivar una instrucción de Python con comentarios

Esta es probablemente la razón más práctica para usar comentarios en el día a día. Imagina que tienes esta instrucción:

python print("Esta línea deseo ignorarla")

Al ejecutar, aparece en la terminal junto con el resto del programa. Pero si le agregas un numeral al inicio, Python la salta sin borrarla del archivo:

python

print("Esta línea deseo ignorarla")

¿Por qué querrías ignorar una instrucción si estás trabajando en Python? Hay dos escenarios típicos: cuando esa línea genera un error y necesitas aislarla para depurar, o cuando estás probando partes específicas del código y quieres desactivar otras temporalmente sin perder lo escrito.

Es una técnica que vas a usar constantemente cuando empieces a construir programas más grandes.

Cuándo conviene comentar y cuándo no

Comentar de más también ensucia el código. La idea no es narrar cada línea, sino aclarar lo que no se entiende a simple vista.

• Comenta cuando una instrucción tiene una intención que no es obvia.
• Comenta cuando desactivas código temporalmente para pruebas o debugging.
• Comenta para dejar contexto a quien revise el archivo después de ti.
• Evita comentar lo que ya dice el propio código de forma evidente.

Una buena práctica es escribir el comentario pensando en tu yo del futuro o en alguien que abre el archivo por primera vez. Si esa persona entiende rápido, el comentario cumplió su trabajo.

Ahora te toca a ti: en la caja de comentarios de Platzi puedes seleccionar la opción de código, elegir Python y dejar un comentario de una línea y otro multilínea. ¿Te animas a compartirlo?