Resumen
Es clave dominar los comentarios en Python para escribir código claro, colaborativo y controlable. Aquí verás cómo usar el símbolo numeral para comentar una línea, añadir comentarios al final de una instrucción y crear comentarios multilínea con comillas triples, además de cómo “apagar” temporalmente líneas que no quieres ejecutar.
¿Por qué usar comentarios en Python?
Comentar sirve para mejorar la legibilidad, documentar decisiones y desactivar código sin borrarlo. Python omite todo lo que está después del numeral en la misma línea, por lo que no afecta la ejecución ni la salida en la terminal. También es útil cuando estás probando cambios o aparece un error y necesitas aislarlo.
- Hacer el código más fácil de leer y mantener.
- Explicar la intención de una instrucción específica.
- Desactivar líneas sin eliminarlas.
- Evitar salidas no deseadas en la terminal.
- Trabajar con archivos .py correctamente.
¿Cómo comentar una línea y al final de una instrucción?
Comenzar es simple: crea un archivo con extensión .py y asegúrate de ejecutarlo con la opción run file. Si escribes texto plano sin sintaxis válida, Python marca error; al comentarlo con el numeral, se ignora y desaparece el error en el editor.
¿Cómo crear un comentario de una sola línea con el numeral?
Usa el símbolo numeral al inicio de la línea. Python omitirá esa línea al ejecutar.
# Esta es una línea de código (comentada).
print("Hola, mundo")
- La línea comentada no se ejecuta.
- En la terminal verás solo Hola, mundo.
¿Cómo añadir un comentario al final de un print?
Comentar al final de una instrucción es útil para explicar qué hace.
print("Hola, mundo") # imprime "Hola, mundo".
- Python ignora todo a la derecha del numeral en esa línea.
- La instrucción se ejecuta con normalidad.
¿Cómo escribir comentarios multilínea y desactivar código?
Cuando necesitas más contexto, puedes comentar varias líneas. Hay dos formas: usando numerales en cada línea o utilizando comillas triples.
¿Cómo hacer multilínea con múltiples numerales y comillas triples?
Con múltiples numerales:
# Este es un comentario.
# Puede ocupar varias líneas.
# Python lo ignorará.
Con comillas triples:
"""
Este será un comentario multilínea.
También será ignorado por Python.
"""
- Ambas opciones evitan impacto en la terminal.
- Las comillas triples permiten escribir bloques de texto cómodamente.
¿Cómo ignorar una instrucción de Python temporalmente?
Si quieres “apagar” una línea (por ejemplo, para pruebas o si causa un error), coméntala.
print("Hola, mundo")
# print("Esta línea deseo ignorarla")
- Verás solo Hola, mundo en la terminal.
- Es útil para depurar o desactivar comportamiento puntual.
¿Te animas a practicar? En la caja de comentarios de Platzi elige “Colocar código”, selecciona Python y comparte un comentario de una sola línea y otro multilínea. Cuenta qué te resultó más útil y por qué.