Espacio publicitario (banner)
AD

¿Ya dominas lo básico? Un curso estructurado de Python es la vía rápida para dar el salto.

Ver cursos de Python en Udemy

Enlace de afiliado. No te cuesta nada extra.

🐍Lecciones de Python
Lección 18 / 69

Escribir comentarios

En esta lección verás cómo escribir comentarios en Python, para dejar un código fácil de entender cuando vuelvas a él más adelante. Está pensada para quien busca «cómo comentar código en Python».

Un comentario es una nota para personas que no afecta en nada a la ejecución del programa. Todo lo que va después de # es un comentario. Para notas de varias líneas también se usan mucho las comillas triples. Los comentarios existen para que el código resulte más comprensible después, ya sea para ti o para otra persona.

El código de ejemplo usa un comentario de una línea para explicar una variable y un comentario de varias líneas (entre comillas triples) para una nota más larga. Anotar «por qué hace falta esta lógica» resulta enormemente útil cuando tú o un compañero volváis al código meses después.

Un error habitual al empezar es comentar en exceso, hasta el punto de que los comentarios dificultan la lectura. Lo que hace el código suele quedar claro leyendo el propio código, así que los comentarios son más útiles cuando explican el «por qué», no el «qué». Un comentario con """ que describe una función se llama además «docstring».

En el desarrollo real, que existan o no comentarios marca una diferencia enorme en un equipo. Las docstrings las recogen automáticamente muchas herramientas de documentación, y lo bien que alguien escribe comentarios se considera parte de su competencia profesional.

Python
SALIDA

💡 El motor de Python puede tardar unos segundos en cargarse la primera vez que ejecutas código.

Espacio publicitario (banner)
Espacio publicitario (en el artículo)