Nombres de variables

0.1 Motivación

Los nombres de variables son la forma en que te comunicas con otros programadores y contigo mismo. Un buen nombre hace que tu código sea autoexplicativo, reduciendo la necesidad de comentarios y facilitando el mantenimiento. Elegir nombres claros no es solo estilo: es una habilidad fundamental que distingue a un programador novato de uno profesional.

0.2 Intuición

Piensa en los nombres de variables como las etiquetas de los cajones en una oficina. Si cada cajón tiene una etiqueta clara (“Facturas”, “Contratos”, “Informes”), cualquiera puede encontrar lo que busca. Si usas etiquetas como “Cosa1”, “Cosa2” o “Eso”, nadie (ni tú) sabrá qué hay dentro. En programación pasa igual: total_ventas es mucho mejor que x o temp.

0.3 Modelo mental

Las reglas de nombres en Python son estrictas (el intérprete te dará error si no las cumples) y convencionales (buenas prácticas que no son obligatorias pero que mejoran la legibilidad).

0.4 Desarrollo

nombre = "Ana"        # Letras
_nombre = "Ana"       # Empieza con guión bajo
nombre2 = "Ana"       # Termina con número
nombre_completo = "Ana"  # Guión bajo
Nombre = "Ana"        # Mayúscula inicial (pero no recomendado)
NOMBRE = "Ana"        # Todo mayúsculas (para constantes)

2nombre = "Ana"       # Empieza con número
mi-nombre = "Ana"     # Contiene guión (-)
mi nombre = "Ana"     # Contiene espacio
if = "Ana"            # Palabra reservada

# ✅ Snake Case (recomendado)
precio_total = 100
nombre_usuario = "Carlos"
lista_productos = ["manzana", "pera"]

# ❌ Camel Case (no recomendado en Python)
precioTotal = 100
nombreUsuario = "Carlos"

# No usar como variables
# False, class, finally, is, return, None, continue, for, lambda, try,
# True, def, from, nonlocal, while, and, del, global, not, with,
# as, elif, if, or, yield, assert, else, import, pass, break, except, in, raise

0.5 Ejemplos

Mínimo — Nombres legales e ilegales:

# ✅ Legales
nombre = "Ana"
_edad = 25
precio_producto = 99.99
total_1 = 100

# ❌ Ilegales (descomentar da error)
# 1er_lugar = "primero"     # Empieza con número
# mi-variable = 10          # Tiene guión
# class = "programacion"    # Palabra reservada
# mi variable = "texto"     # Tiene espacio

Progresivo — Nombres descriptivos vs. nombres confusos:

# ❌ Malos nombres (difíciles de entender)
a = 12.5
b = "Juan"
c = a * 1.21
print(c)

# ✅ Buenos nombres (autoexplicativos)
precio_base = 12.5
nombre_cliente = "Juan"
precio_con_iva = precio_base * 1.21
print(precio_con_iva)

Real — Sistema de gestión de inventario:

# Configuración del sistema
LIMITE_INVENTARIO = 100          # Constante (mayúsculas)
ruta_archivo = "/data/inventario.csv"  # Variable normal
_contador_interno = 0            # Variable "privada"

# Datos de productos
producto_nombre = "Laptop"
producto_precio = 850.50
producto_stock = 15
producto_activo = True

# Mensaje de estado
print("Producto:", producto_nombre)
print("Stock:", producto_stock, "unidades")
print("Stock bajo:", producto_stock < 10)  # Resultado: False

0.6 Errores comunes

0.7 Buenas prácticas

1. Nombres descriptivos pero concisos:

   python

   # ❌ Demasiado corto
   a = 100
   
   # ❌ Demasiado largo
   precio_total_de_la_compra_sin_iva = 100
   
   # ✅ Justo
   precio_base = 100

2. Usa verbos para funciones, sustantivos para variables:

   python

   # Función: acción (verbo)
   def calcular_total():
       pass
   
   # Variable: dato (sustantivo)
   total = 100

3. Sé consistente:

   python

   # ❌ Inconsistente
   nombre_usuario = "Ana"
   user_email = "ana@mail.com"
   
   # ✅ Consistente
   nombre_usuario = "Ana"
   email_usuario = "ana@mail.com"

4. Evita abreviaturas no estándar:

   python

   # ❌ Confuso
   prv = "Programación"
   
   # ✅ Claro
   curso = "Programación"

5. Usa nombres que tengan sentido en el contexto del programa.

0.8 Ejercicio

Básico — Corrige nombres ilegales

Los siguientes nombres de variables tienen errores. Corrígelos para que sean válidos y sigan las convenciones de Python:

# Corrige estos nombres ilegales/malos
1er_trimestre = 2024
total-ventas = 15000
mi variable = "casa"
class = "Python"
NombreDeUsuario = "ana"
precioTotal = 99.99

Solución (no mires hasta haberlo intentado):

# Versión corregida (snake case)
primer_trimestre = 2024
total_ventas = 15000
mi_variable = "casa"
clase = "Python"  # O mejor: nombre_clase
nombre_usuario = "ana"
precio_total = 99.99

0.9 Síntesis

• Reglas obligatorias: letras, números, _; no empezar con número; sin espacios ni -; sin palabras reservadas.
• Sensible a mayúsculas: nombre ≠ Nombre ≠ NOMBRE.
• Snake Case: convención recomendada para variables (mi_variable).
• Descriptivos: usa nombres que revelen el propósito de la variable.
• Constantes en mayúsculas: LIMITE = 100.
• Palabras reservadas: no usar if, for, class, while, etc.

0.10 Qué sigue

• Relacionado: variables (asignación, tipos), palabras reservadas
• Siguiente tema: Tipos de datos — aprenderás a manejar diferentes tipos de datos y sus propiedades.