Desarrollo con Python
  • Conceptos básicos
    • 🐍Introducción a Python
      • 🐍Variables
      • 🐍Strings
      • 🐍Números
      • 🐍Comentarios
      • 🐍Funciones
      • 🐍Funciones Propias
      • 🐍Zen of Python
    • 💿Primer programa
  • Operadores en python
    • ❎Operadores
      • ❎Operadores Aritméticos
      • ❎Operadores de asignación
      • ❎Booleanos
      • ❎Operadores de comparación
      • ❎Operadores lógicos
      • ❎Operadores de identidad
      • ❎Operadores de pertenencia
  • Datos Complejos
    • ▶️Datos complejos
      • ▶️Listas
      • ▶️Tuplas
      • ▶️Diccionarios
      • ▶️Bytes y Bytearrays
      • ▶️Sets
      • ▶️NoneType
    • 💿Caso práctico: Agenda
  • Control de flujo
    • 🛑Estructuras de control de flujo
      • 🛑Sentencias if/elif/else
      • 🛑Sentencia for
      • 🛑Sentencia while
      • 🛑break/continue/pass
    • ⚠️Excepciones en Python3
    • 🎯Caso práctico: 4 in Row
  • Orientacion a objetos
    • 💾Scope y Namespaces
    • 💾Clases en Python 3
    • 💾Métodos y atributos
    • 💾Clases y Objetos
    • 💾Decorators
  • Trabajando con objetos
    • 🔢Trabajando con Objetos
      • 🔢Trabajando con Números
      • 🔢Trabajando con Strings
      • 🔢Trabajando con Listas
      • 🔢Trabajando con Tuplas
      • 🔢Trabajando con Sets
      • 🔢Trabajando con Diccionarios
  • Programación Modular
    • 🧩Programación modular
      • 🧩Paquetes
      • 🧩PIP y paquetes externos
      • 🧩Pandas
      • 🧩NumPy
      • 🧩Matplotlib
      • 📄Caso Práctico
  • Proyectos finales
    • 🐍Videojuego Snake
    • 📥Detección de Spam con Machine Learning
Con tecnología de GitBook
En esta página
  • 1. Comentarios básicos
  • 2. Comentarios de varias líneas
  1. Conceptos básicos
  2. Introducción a Python

Comentarios

Los comentarios son una parte fundamental de cualquier lenguaje de programación. Permiten describir partes del código que desarrollamos de manera que sea mucho más facil de comprender.

En Python existen diferentes tipos de comentarios que podemos utilizar para documentar nuestro código.

1. Comentarios básicos

La manera más básica de poner comentarios en Python es utilizando el símbolo #

In [1]:

# Esto es un comentario en Python

También podemos poner comentarios después de alguna sentencia en Python

var = "Hola mundo" 
# Variable que contiene una cadena de texto

Los comentarios en Python deben ser cortos y transmitir información relevante para el desarrollador. No debe saturarse el código de un número muy elevado de comentarios que no transmiten información significativa.

2. Comentarios de varias líneas

En algunas ocasiones es posible que necesitemos poner comentarios de varias líneas. Python no permite crear un comentario de varias líneas utilizando el símbolo #.

# Esto es un comentario
de varias líneas
en Python

  Cell In[3], line 2
    de varias líneas
       ^
SyntaxError: invalid syntax

La forma más sencilla de poner comentarios de varias líneas en Python, es comenzar cada una de las líneas con el símbolo #

# Esto es un comentario
# de varias líneas
# en Python

Otra forma existente para definir comentarios de múltiples líneas en Python consiste en situar el texto entre """. Como ya hemos comentado en secciones anteriores, esta construcción realmente esta creando un string de varias líneas.

var = "Hola mundo"

""" 
Esto es un comentario
de varias líneas
en Python
"""

var
'Hola mundo'

Mientras que esto le da la funcionalidad de multilínea al comentario, debemos tener claro que no es técnicamente un comentario. Es una cadena que no está asignada a ninguna variable, por lo que será ignorada en tiempo de ejecución y no aparecerá en el bytecode de tu programa.

Sin embargo, debemos tener cuidado con el uso de este tipo de comentarios multilínea. Dependiendo de dónde se sitúen en nuestro programa, podrían convertirse en docstrings, que es un tipo de documentación que se asocian a una función o método.

AnteriorNúmerosSiguienteFunciones

Última actualización hace 1 año

🐍
🐍
Page cover image