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

En este momento, las únicas formas que puedo ver de comentar el código es comenzar cada línea con un #, o encerrar el código entre comillas triples: """.

El problema con estos es que al insertar # antes de que cada línea sea engorrosa 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».

6

Python no tiene tal mecanismo. Anteponer un # a cada línea para bloquear el comentario. Para más información, ver PEP 8. La mayoría de los IDE de Python admiten un mecanismo para hacer el comentario de bloque con los signos de almohadilla automáticamente por usted. Por ejemplo, en IDLE en mi máquina, es Alt+3 y Alt+4.

No use comillas triples; como descubrió, esto es para cadenas de documentación, no para bloquear comentarios, aunque tiene un efecto similar. Si solo está comentando cosas temporalmente, esto está bien como medida temporal.

22

La única cura que conozco para esto es un buen editor. Perdón.

2

Oculte las comillas triples en un contexto que no se confundirá con una cadena de documentos, por ejemplo:

'''
...statements...
''' and None

o:

if False: '''
...statements...
'''

4

La única forma en que puede hacer esto sin comillas triples es agregar un:

if False:

Y luego sangra todo tu código. Tenga en cuenta que el código aún deberá tener la sintaxis adecuada.


Muchos IDE de Python pueden agregar # para usted en cada línea seleccionada, y elimínelas cuando elimine los comentarios también. Del mismo modo, si usa vi o Emacs puede crear una macro para hacer esto por usted para un bloque de código.

5

En el uso de JetBrains PyCharm en Mac Mando + / para comentar / descomentar el bloque de código seleccionado. En Windows, use CONTROL + /.

3

Mx comentario-región, en Emacs’Modo Python.

1

Al menos en VIM, puede seleccionar la primera columna de texto que desea insertar usando el modo Block Visual (CTRL+V en VIM que no son de Windows) y luego anteponer un # antes de cada línea usando esta secuencia:

I#<esc>

En modo Block Visual I se mueve al modo de inserción con el cursor antes del bloque en su primera línea. El texto insertado se copia antes cada línea en el bloque.

0

comm='''
Junk, or working code 
that I need to comment.
'''

Puedes reemplazar comm por una variable de su elección que sea quizás más corta, fácil de escribir, y usted sabe que no ocurre (y no ocurrirá) en sus programas. Ejemplos: xxx, oo, null, nil.

1

En vi:

  • Vaya a la parte superior del bloque y márquelo con la letra a.
  • Ve al final del bloque y márcalo con la letra b

Entonces hazlo

:'a,'b s!^!#!

1

En Visual Studio usando el Herramientas de Python para Visual Studio, los bloques pueden ser comentados por control+K, control+C y descomentado por control+K, control+U.

2

yo suelo Bloc de notas ++ en una máquina con Windows, seleccione su código, escriba CTRL-K. Para descomentar, seleccione el código y presione control + Cambio + K.

Por cierto, Notepad ++ funciona muy bien como editor de Python. Con autocompletado, plegado de código, resaltado de sintaxis y mucho más. ¡Y es gratis como en el habla y como en la cerveza!

Sí, lo hay (dependiendo de su editor). En PyDev (y en Estudio Aptana con PyDev):

1

En Eclipse + PyDev, Los comentarios de bloques de Python son similares a los comentarios de bloques de Java de Eclipse; selecciona las líneas que quieres comentar y usa control + / comentar. Para descomentar un bloque comentado, haga lo mismo.