Cómo comentar un bloque de código en Python

¿Existe un mecanismo para comentar grandes bloques de código Python?

Ahora mismo, las únicas formas que veo de comentar el código son o bien empezar cada línea con un #, o bien encerrar el código entre comillas triples: `""".

El problema con estos es que insertar # antes de cada línea es engorroso y """ hace que la cadena que quiero usar como comentario aparezca en la documentación generada.

Después de leer todos los comentarios, la respuesta parece ser "No".

Solución

Python no tiene este mecanismo. Añade un # a cada línea para bloquear el comentario. Para más información vea PEP 8. La mayoría de los IDEs de Python soportan un mecanismo para hacer el comentario en bloque con signos de libra automáticamente. Por ejemplo, en IDLE en mi máquina, es Alt+3 y Alt+4.

No utilices las comillas triples; como has descubierto, esto es para las cadenas de documentación, no para los comentarios en bloque, aunque tiene un efecto similar. Si sólo está comentando cosas temporalmente, esto está bien como medida temporal.

Comentarios (30)

La única cura que conozco para esto es un buen editor. Lo siento.

Comentarios (2)

La única forma de hacerlo sin comillas triples es añadir un:

if False:

Y luego sangrar todo su código. Tenga en cuenta que el código todavía tendrá que tener una sintaxis adecuada.


Muchos IDEs de Python pueden añadir # por ti en cada línea seleccionada, y eliminarlos también al des-comentar. Igualmente, si usas vi o Emacs puedes crear una macro que haga esto por ti para un bloque de código.

Comentarios (5)