Cómo comentar varias líneas en Python: métodos, atajos y buenas prácticas

1. Introducción

2. Método básico de comentarios en Python

2.1 Comentarios de una sola línea

# Esto es un comentario de una línea
print("Hola, Mundo!")  # También se pueden añadir comentarios al final de una línea

2.2 Comentarios en varias líneas

# Este código no se ejecutará
# Comentarios en varias líneas
print("Esta línea está desactivada")

3. Métodos para comentar varias líneas

3.1 Uso de atajos para comentar con #

# Ejemplo: comentar varias líneas seleccionadas
# a = 1
# b = 2
# c = a + b

3.2 Uso de comillas triples

'''
Este bloque quedará comentado.
Es útil cuando quieres desactivar varias líneas.
'''
print("Esto sí se ejecutará")

4. Ejemplos y consideraciones al usar comillas triples

4.1 Ejemplo correcto

def sample():
    '''
    Este bloque será tratado como comentario.
    La indentación es consistente.
    '''
    print("Esta parte sí se ejecutará")

4.2 Ejemplo con error

def sample():
'''
Este comentario producirá un error
La indentación no es correcta
'''
    print("Aquí ocurrirá un error")

5. Atajos de comentarios en entornos de desarrollo Python

5.1 PyCharm

5.2 Visual Studio Code

5.3 Jupyter Notebook

6. Mejores prácticas al comentar

6.1 Inserción adecuada de comentarios

# Recibe dos parámetros a y b, y devuelve su suma
def add(a, b):
    return a + b

6.2 Evitar comentarios excesivos

# Asignar 1 a a
a = 1
# Asignar 2 a b
b = 2
# Sumar a y b
c = a + b

7. Conclusión