Buenas prácticas al nombrar variables

🧩 Recordemos

cantidad_estudiantes = 1000
nombre_curso = "Programación en Python"
calificacion = 4.99
esta_publicado = True

Estos son los ejemplos de variables que usamos en la lección anterior:

🤔 Pregunta inicial

cantidad_estudiantes = 1000
nombre_curso = "Programación en Python"
calificacion = 4.99
esta_publicado = True

Mira este código por un momento. Hay cuatro cosas que he hecho consistentemente. ¿Puedes ver cuáles son?

(Pausa unos segundos… piensa 👀)

1. Nombres descriptivos y significativos

Cada nombre de variable explica claramente su propósito.

cantidad_estudiantes = 1000
nombre_curso = "Programación en Python"

1. Nombres descriptivos y significativos

❌ En cambio, nombres como estos no comunican nada:

nc = "Programación en Python"
c1 = "Python"

Cuando alguien lea tu código, debe entender de inmediato qué representa cada variable.

Esto hace tu código más legible, mantenible y profesional.

✨ Excepción razonable

Puedes usar nombres cortos como x, y, z solo cuando trabajes con coordenadas o cálculos matemáticos.

x = 12
y = 7

🔤 2. Usa letras minúsculas

En Python, los nombres de variables se escriben en minúsculas.

nombre_curso = "Python"    # ✅ correcto
Nombre_Curso = "Python"    # ❌ incorrecto
NOMBRE_CURSO = "Python"    # ❌ incorrecto

🧩 3. Usa guiones bajos para separar palabras

No podemos tener espacios en los nombres de variables, por eso usamos guiones bajos (underscore) _ para mejorar la lectura:

nombre_curso = "Python para principiantes"  # ✅ correcto
nombrecurso = "Python para principiantes"   # ❌ difícil de leer

⚙️ 4. Espacios alrededor del signo igual

Otra buena práctica es dejar espacio antes y después del =.

nombre_curso = "Python"   # ✅ limpio y claro
nombre_curso="Python"     # ❌ código apretado

⚙️ 4. Espacios alrededor del signo igual

Otra buena práctica es dejar espacio antes y después del =.

nc = "Programación en Python"
c1 = "Python"

El código limpio es más fácil de leer y mantener.

Piensa en él como un texto bien redactado, no solo instrucciones para la máquina.

💅 Código limpio y hermoso

nc="Python";calif=5;PUB=True  # 😣 ¡difícil de entender!

A esto lo llamamos “código limpio” o clean code. Un buen programa debe leerse como una historia o un artículo.

Evita el “código sucio” o desordenado:

💅 Código limpio y hermoso

nombre_curso = "Python"
calificacion = 5
esta_publicado = True

y escribe así.

📜 PEP 8 — Guía de estilo de Python

PEP 8 es la guía oficial de estilo de Python.

Nos enseña cómo escribir código ordenado, legible y coherente.

Si usas Google Colab o VS Code, puedes instalar autopep8, una herramienta que corrige automáticamente el formato de tu código al guardar.

Pero más allá de la herramienta, la meta es:

💡 Desarrollar el hábito de escribir código limpio desde el inicio.