¿Qué es un comentario?
Un comentario es una línea o bloque de texto dentro del código que no se ejecuta.
Su función principal es explicar el código para que tú (o cualquier otra persona) pueda entenderlo fácilmente en el futuro.
Los comentarios no afectan el comportamiento ni el rendimiento del programa.
¿Para qué sirven los comentarios?
- Para explicar qué hace una parte del código.
- Para recordar por qué se tomó cierta decisión en la programación.
- Para desactivar temporalmente alguna línea de código (comentándola) sin eliminarla.
- Para mejorar la legibilidad y mantenimiento de proyectos grandes.
Los comentarios son señal de buenas prácticas de programación.
Tipos de Comentarios en Python:
1. Comentarios de Una Sola Línea:
Se escriben usando el símbolo #. Todo lo que siga después del # será ignorado por Python.
# Este es un comentario de una sola línea
nombre = "Juan" # También puedo comentar al final de una línea de código2. Comentarios de Varias Líneas:
Se escriben usando tres comillas simples (''') o tres comillas dobles (""") al principio y al final. Esto permite escribir explicaciones largas que ocupen varias líneas.
Ejemplo usando comillas simples:
'''
Este es un comentario
de varias líneas
explicando el código
'''
print("Hola mundo")Ejemplo usando comillas dobles:
"""
También puedo usar
tres comillas dobles
para comentarios largos
"""
print("Bienvenido")Nota: Técnicamente, las comillas triples crean una cadena de texto multilínea. Si no se asigna a ninguna variable, Python la ignora, por eso las usamos como comentarios multilínea.
Buenas prácticas para comentar código:
- No comentes lo obvio. (Ejemplo:
a = 5 # asigna 5 a a→ No es necesario). - Usa comentarios claros y concisos.
- Mantén actualizado el comentario si cambias el código.
- Sé profesional y respetuoso en los comentarios (nada de bromas internas o lenguaje inadecuado).
- Usa el mismo idioma en todo tu código (si programas en español, comenta en español).