Los comentarios son fundamentales para documentar el código y hacer que sea más comprensible. En este tutorial veremos cómo utilizar comentarios en Python.
¿Qué son los comentarios?
Los comentarios son fragmentos de texto en el código que no se ejecutan y se utilizan para explicar o documentar lo que hace el código. Esto ayuda a otros (o a ti mismo en el futuro) a entender mejor el propósito y la lógica detrás del código.
Tipos de comentarios en Python
En Python, hay dos tipos principales de comentarios:
- Comentarios de una sola línea
- Comentarios de varias líneas
Vamos a ver como utilizar cada uno de ellos.
Comentarios de una sola línea
Los comentarios de una sola línea comienzan con el símbolo #. Todo el texto que sigue a este símbolo en la misma línea será ignorado por el intérprete de Python.
Ejemplo:
# Este es un comentario de una sola línea
print("Hola, mundo!") # Esto imprime un mensaje en pantallaComentarios de Varias Líneas
Los comentarios de varias líneas se pueden hacer utilizando comillas triples (»’ o «»»). Esto permite incluir comentarios que ocupen más de una línea. Aunque no es su uso principal, Python también permite que las cadenas multilínea se utilicen como comentarios, siempre y cuando no se asignen a ninguna variable.
Ejemplo:
"""
Este es un comentario de varias líneas.
Puede incluir múltiples líneas de texto.
Python ignorará todo esto.
"""
print("Hola, mundo!")Buenas Prácticas de Comentarios
Para que los comentarios sean realmente útiles, considera las siguientes buenas prácticas:
- Sé claro y conciso: los comentarios deben ser fáciles de entender. Evita la jerga innecesaria.
- Explica el por qué, no el qué: a menudo, el código es autoexplicativo en cuanto a lo que hace. Los comentarios deben explicar por qué se tomó una decisión o se realizó una acción determinada.
- Mantén los comentarios actualizados: si cambias tu código, asegúrate de actualizar o eliminar los comentarios relacionados para evitar confusiones.
- Usa comentarios para secciones de código: puedes usar comentarios para separar lógicas o secciones de tu código, lo que facilita la lectura.
- Evita comentarios obvios: no comentes cosas que sean evidentes. Por ejemplo, no es necesario comentar
x = x + 1con “Incrementa x en 1”.
Inicialmente me formé como Técnico en Anális y Diseño de sistemas. Luego ingresé a la escuela de negocios, hice una licenciatura en Administración y obtuve una especialización (Post-grado) en Alta Dirección Empresarial. Desde el año 2007 me dedico a la creación de sitios web, lo cual combino con la consultoría y la capacitación de tecnologías de Internet.
- Variables en Python - noviembre 17, 2025
- Tipos de Datos en Python - noviembre 17, 2025
- Convertir una cadena de texto a mayúsculas o minúsculas utilizando JavaScript - noviembre 14, 2025