El mundo de la programación en Python

Python: comentarios multilínea con comillas triples y atajos

Preguntas frecuentes y colección de consejos
目次

1. Conceptos básicos de comentar en Python y su importancia

Comentar en Python es una herramienta importante para que el código sea fácil de entender cuando otros o tú mismo lo revisen más adelante. Al dejar explicaciones o notas del código, se mejora la mantenibilidad del programa y se facilita identificar las causas de errores y explicar la lógica. Además, también resulta útil para desactivar temporalmente código durante el desarrollo y realizar pruebas.

1.1 Fundamentos de los comentarios de una sola línea

En Python, los comentarios de una sola línea usan «#». Al colocar «#» al inicio de la línea, toda esa línea se trata como un comentario.
# Esto es un comentario
print("Hello, World!")  # Esta parte también se considera un comentario
De este modo, puedes añadir comentarios que expliquen el código y que sean útiles en futuras modificaciones.

1.2 Descripción general de los comentarios de varias líneas

Para comentarios de varias líneas, lo más común es añadir «#» a cada línea por separado. Esto requiere insertar «#» manualmente en cada línea, pero es muy eficaz cuando se desea desactivar bloques de código largos.
# Esta es la primera línea de comentario
# Esta es la segunda línea de comentario
# Esta es la tercera línea de comentario
También existen algunos métodos eficientes para ahorrar trabajo con los comentarios de varias líneas, que se explicarán más adelante.

2. Dos formas de comentar varias líneas en Python

Existen varias técnicas útiles para comentar varias líneas. A continuación se presentan dos métodos representativos.

2.1 Comentar varias líneas con «#»

Comentar varias líneas con «#» es el método más simple y habitual.
# Este es el comentario de la línea 1
# Este es el comentario de la línea 2
# Este es el comentario de la línea 3
Sin embargo, cuando hay muchas líneas resulta laborioso, por lo que este método es adecuado para bloques relativamente pequeños.

2.2 Comentar varias líneas con comillas triples

En Python, al usar tres comillas simples (»’) o tres comillas dobles («»») de forma consecutiva, es posible comentar varias líneas. Esto se utiliza originalmente como cadena de documentación (docstring), pero también se emplea como alternativa para comentar.
"""
Aquí hay un comentario de varias líneas
Se pueden desactivar varias líneas
"""
Sin embargo, este método se reconoce como una cadena, por lo que estrictamente no es un comentario. Puede hacer que el código consuma recursos innecesarios, por lo que se debe tener cuidado, especialmente en proyectos de gran tamaño o cuando el uso de memoria es importante.</final

3. Errores comunes al comentar en Python y cómo evitarlos

Hay varios aspectos a tener en cuenta al comentar código. En particular, es necesario ser cauteloso con los errores de indentación y con el uso de las comillas triples.

3.1 Evitar errores de indentación

Python impone reglas estrictas de indentación; si el código no está indentado correctamente, se produce un IndentationError. Incluso al comentar con comillas triples, si la indentación se desajusta puede provocar errores inesperados.
def example():
    """
    Esto es un comentario
    """
        print("Hello, World!")  # Esto provocará un error de indentación
En Python es muy importante mantener la indentación consistente.

3.2 Problemas de consumo de recursos con las comillas triples

Comentar con comillas triples es reconocido por el intérprete de Python como una cadena, por lo que consume memoria. Por ello, conviene evitar abusar de este método en bloques de código grandes. Es un método más adecuado para documentación que para comentar código.

4. Comentar de forma eficiente con atajos de teclado

En muchos editores y entornos de desarrollo integrados (IDE) se ofrecen atajos de teclado que permiten comentar varias líneas al instante. A continuación se muestran los atajos de teclado en algunos editores representativos. Visual Studio Code: En Windows, Ctrl + /; en Mac, Cmd + / PyCharm: En Windows, Ctrl + /; en Mac, Cmd + / Sublime Text: En Windows, Ctrl + /; en Mac, Cmd + / Al aprovechar estos atajos de teclado, se puede agilizar la tarea de comentar y reducir significativamente el tiempo de desarrollo. Por ejemplo, al seleccionar varias líneas y usar el atajo, se pueden comentar al instante, lo que resulta muy útil durante la depuración y las pruebas.
年収訴求

5. Conclusión

En este artículo, presentamos cómo realizar comentarios de varias líneas en Python. Desde los comentarios de una sola línea usando «#», hasta los comentarios de varias líneas con comillas triples, y métodos eficientes para comentar mediante atajos de teclado, cubrimos diversas técnicas. En el desarrollo con Python, comentar es una herramienta indispensable para mejorar la legibilidad y la mantenibilidad del código. Al comentar adecuadamente, se mejora la calidad general del proyecto y también se facilita la comprensión entre los miembros del equipo. Utiliza estas técnicas para mejorar aún más la eficiencia del desarrollo en Python.