Para comentar varias líneas en Python puedes usar el símbolo # al inicio de cada línea que quieras comentar o, si necesitas comentar un bloque completo de código, puedes envolverlo entre comillas triples (''' o """).
Recuerda que los comentarios pueden hacer que el código sea más legible y más fácil de mantener, así que debes aprovechar las herramientas del lenguaje para mejorar tu flujo de trabajo.
Voy a guiarte paso a paso para que puedas comentar varias líneas en Python correctamente y mejorar la calidad de tu código.
Cómo comentar varias líneas en Python
Comentar varias líneas en Python puede hacerse de distintas maneras, dependiendo de lo que necesites.
Aquí te explicaré las formas más comunes de hacerlo.
Paso 1: Usar el símbolo # para comentarios de una línea
Aunque este paso no es específicamente para comentar varias líneas en Python, es fundamental conocer cómo se hace un comentario en una sola línea antes de pasar a los bloqueos.
El símbolo # se usa para comentarios en una sola línea:
# Este es un comentario de una sola línea
print("Hola, Mundo") # Este es otro comentario en línea
Para saber comentar varias líneas en Python correctamente, primero necesitas dominar cómo hacer comentarios de una sola línea, ya que en muchos casos, solo necesitas comentar fragmentos pequeños de tu código.
Paso 2: Comentar varias líneas de manera secuencial
La forma más sencilla de comentar varias líneas en Python de manera manual es usando el símbolo # en cada línea que quieras comentar.
Si tienes varias líneas que deseas comentar, simplemente añades un # al comienzo de cada una.
Código desordenado:
# Este es un comentario en la primera línea
# Y aquí va otro comentario
# A continuación, un tercer comentario
print("Código que quiero ejecutar")
Código organizado con comentarios:
# Este es un comentario en la primera línea
# Y aquí va otro comentario
# A continuación, un tercer comentario
print("Código que quiero ejecutar")
Paso 3: Usar comillas triples para comentarios de bloque
Para comentar varias líneas en Python fácilmente, puedes usar comillas triples (''' o """) para envolver el bloque de código que deseas comentar.
Esta es una de las formas más rápidas de comentar bloques enteros de código.
Código antes de comentar:
print("Línea 1")
print("Línea 2")
print("Línea 3")
Código comentado con comillas triples:
'''
print("Línea 1")
print("Línea 2")
print("Línea 3")
'''
Es importante mencionar que, aunque este método funciona para comentar grandes bloques de código, Python lo interpreta como una cadena de texto que no se ejecuta, pero no es estrictamente un «comentario» como el que se hace con el #.
Sin embargo, es ampliamente utilizado cuando se necesita desactivar rápidamente una porción de código.
Paso 4: Usar extensiones de Visual Studio Code para comentar varias líneas
Si usas un editor como Visual Studio Code, puedes utilizar atajos para comentar varias líneas en Python de forma rápida.
Si seleccionas un bloque de texto y presionas Ctrl + / en Windows o Cmd + / en Mac, Visual Studio Code agregará automáticamente un # al principio de cada línea seleccionada.
Este atajo es una forma rápida de comentar varias líneas en Python sin tener que escribir los # manualmente.
Ejemplos aplicados a la vida real
A medida que trabajas en proyectos más grandes, saber comentar varias líneas en Python se convierte en una habilidad clave.
Aquí te muestro algunos ejemplos aplicados a situaciones comunes que he experimentado.
1. Comentar temporalmente bloques de código durante la depuración
Cuando estoy depurando un programa y necesito desactivar temporalmente algunas secciones de código, utilizar comentar varias líneas en Python me permite hacer esto rápidamente.
A menudo selecciono todo un bloque de código y lo comento usando comillas triples o el atajo de teclado, lo que me ayuda a aislar el error.
'''
x = 10
y = 20
print(x + y) # Esta línea la desactivo para probar otro bloque
'''
2. Explicar la lógica compleja dentro de una función
Cuando mi código contiene una lógica compleja que quiero explicar para futuros desarrolladores o incluso para mí mismo, comentar varias líneas en Python me permite incluir descripciones detalladas dentro del bloque de código.
De esta forma, puedo detallar lo que cada parte del código está haciendo y cómo se relaciona con el resto del programa.
'''
Esta parte del código se encarga de conectar con la base de datos
y verificar si los datos ingresados son válidos antes de proceder
con la actualización del registro.
'''
def update_record(record_id, new_data):
# Lógica para actualizar el registro
pass
3. Desactivar bloques de código para pruebas rápidas
En situaciones de pruebas rápidas o experimentación, comentar varias líneas en Python me permite desactivar por completo ciertos bloques de código sin tener que eliminarlos.
Esto es muy útil cuando quiero probar una sección del código sin perder las modificaciones anteriores.
'''
# Código desactivado temporalmente para pruebas
import numpy as np
data = np.array([1, 2, 3])
print(data)
'''
Mejora tus habilidades en desarrollo web en el Bootcamp de Desarrollo Web de KeepCoding. En este curso, aprenderás desde las bases de Python hasta el desarrollo de aplicaciones web completas, y dominarás las mejores prácticas para escribir código limpio y funcional. ¡Inscríbete ahora y lleva tu carrera como desarrollador al siguiente nivel!
