Pregunta

    

Esta pregunta ya tiene una respuesta aquí:

         

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

En este momento, las únicas maneras en que puedo ver de comentando código son o bien comenzar cada línea con un #, o para encerrar el código comillas triples:. """

El problema con estos es que la inserción de <=> antes de cada línea es engorroso y <=> hace que la cadena que quiero usar como un comentario aparecen en la documentación generada.

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

¿Fue útil?

Solución

Python no tiene un mecanismo de este tipo. Anteponer un # a cada línea para bloquear comentario. Para obtener más información, consulte PEP 8 . La mayoría de los entornos de desarrollo de Python apoyan un mecanismo para hacer los signos libras-bloque-comentando-con-automática para usted. Por ejemplo, en IDLE en mi máquina, que es Alt + 3 y Alt + 4 .

No utilice comillas triples; como has descubierto, esto es para las cadenas de documentación no bloquear los comentarios, aunque tiene un efecto similar. Si acaba de comentar cosas fuera temporalmente, esto está muy bien como una medida temporal.

Otros consejos

La única cura que sé de esto es un buen editor. Lo siento.

Ocultar las comillas triples en un contexto que no será confundido con un cadena de documentación, por ejemplo:

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

o

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

La única manera de hacer esto sin comillas triples es añadir una:

if False:

Y luego guión todo el código. Tenga en cuenta que el código todavía tendrá que tener la sintaxis correcta.


Muchos IDE Python pueden añadir # para que en cada línea seleccionada, y eliminarlos cuando se des-comentar también. Del mismo modo, si se utiliza vi o Emacs puede crear una macro para hacer esto para usted por un bloque de código.

M-x comentario-región, en 'modo Python Emacs .

En JetBrains PyCharm en Mac usar comando + / para comentar / descomentar bloque seleccionado del código. En Windows, utilice Ctrl + / .

Por lo menos en VIM puede seleccionar la primera columna de texto que desea insertar utilizando Bloquear modo Visual (CTRL+V en ventanas no VIM) y luego agregar el prefijo a un # antes de cada línea utilizando esta secuencia:

I#<esc>

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

vi :

  • Ir a la parte superior del bloque y se marca con la letra a.
  • Ir a la parte inferior del bloque y se marca con la letra b

A continuación, realice

:'a,'b s!^!#!
comm='''
Junk, or working code 
that I need to comment.
'''

Puede reemplazar comm por una variable de su elección que es quizás más corto, fácil de tocar-tipo, y usted sabe que no (y no) se producen en sus programas. Ejemplos:. xxx, oo, null, nil

Sí, hay (en función de su editor). En PyDev (y en Aptana Studio con PyDev):

  • Ctrl + 4 - comentario bloque seleccionado

  • Ctrl + 5 - uncomment bloque seleccionado

En Visual Studio usando las herramientas de Python para Visual Studio , los bloques pueden ser comentados por Ctrl + K , Ctrl + C y uncommented por Ctrl + K , Ctrl + U .

En Eclipse + PyDev , bloque Python comentar es similar a Eclipse Java bloque de comentar; seleccionar las líneas que desea hacer comentarios y utilizar Ctrl + / para comentar. Para eliminar el comentario de un bloque comentado, hacer lo mismo.

Notepad ++ en una máquina Windows, seleccione su código, tipo CTRL-K. Para eliminar el comentario selecciona código y presione Ctrl + Mayúsculas + K .

Por cierto, Notepad ++ funciona muy bien como un editor de Python. Con la finalización automática, plegado de código, resaltado de sintaxis, y mucho más. Y es libre de libertad y como en la cerveza!

El único mecanismo para comentar código Python (entendida como código ignorado por el intérprete) es el # .

Como usted dice, también puede utilizar literales de cadena , que no son ignorados por el intérprete, pero puede ser completamente irrelevante para la ejecución del programa.

En Eclipse usando PyDev , se puede seleccionar un bloque de código y presione Ctrl + # .

Las comillas triples están bien para mí. Se puede utilizar '' 'foo ''' de las cadenas de documentación y '' "barra ''" Para comentarios o viceversa para hacer el código más legible.

Otra solución basada en editor: texto "rectángulos" en Emacs.

Resalte el código que desea comentar, entonces C-x-r-t #

Para un-comentar el código: resalte, y luego C-x-r-k

Yo uso esta todo el día, todos los días. (Asignados a las teclas de atajo, por supuesto.)

Este y potente de búsqueda de expresiones regulares / reemplazar es la razón por la que tolerar otras "excentricidades" de Emacs.

En Eric4 hay una manera más fácil: seleccionar un bloque, escriba Ctrl + M para comentar todo el bloque o Ctrl + alt + M descomentar.

Utilice un buen editor como Scite , seleccione su código, presione Ctrl + Q y hecho.

Si usted no tiene un editor que soporta los comentarios de bloque que puede utilizar una cadena entre comillas triples al principio y al final de su bloque de código a 'eficacia' como comentario. No es la mejor práctica, sin embargo.

Licenciado bajo: CC-BY-SA con atribución
No afiliado a StackOverflow
scroll top