Parte 6 — Nombres de variables
5.24 Los nombres deben explicar el contenido
Un buen nombre permite entender qué guarda una variable.
Buenos ejemplos:
saldo_actual = 1000 total_ingresos = 1500 total_gastos = 425 nombre_usuario = "Daniel" moneda_principal = "CRC"
Malos ejemplos:
x = 1000 a = 1500 cosa = 425 dato = "Daniel"
Los nombres cortos no siempre son incorrectos, pero pueden hacer que el código sea más difícil de entender.
5.25 Utilizar snake_case
En Python es común escribir los nombres utilizando minúsculas y guiones bajos.
Esta forma se llama:
snake_case
Ejemplos:
saldo_actual = 1000 nombre_completo = "Daniel Pérez" total_de_gastos = 425
Se llama snake_case porque los guiones bajos parecen separar las palabras como el cuerpo de una serpiente.
5.26 No utilizar espacios
Esto es incorrecto:
saldo actual = 1000
Python interpreta el espacio como una separación entre elementos.
Utiliza:
saldo_actual = 1000 5.27 No comenzar con números
Incorrecto:
1saldo = 1000
Correcto:
saldo1 = 1000
También sería mejor:
saldo_principal = 1000
Una variable no puede comenzar con un número.
5.28 Letras, números y guiones bajos
Los nombres pueden contener:
Letras. Números. Guiones bajos.
Ejemplos válidos:
cuenta1 = 1000 cuenta_2 = 500 saldo_actual = 1500
Pero no pueden comenzar con un número:
2_cuenta = 500 5.29 No utilizar guiones normales
Esto es incorrecto:
saldo-actual = 1000
Python interpreta el guion como una resta:
saldo - actual
Utiliza guion bajo:
saldo_actual = 1000 5.30 Evitar caracteres especiales
Evita:
saldo! = 1000 saldo$ = 1000 saldo-total = 1000
Utiliza:
saldo_total = 1000 5.31 Mayúsculas y minúsculas
Python distingue mayúsculas y minúsculas.
saldo = 1000 Saldo = 2000 SALDO = 3000
Estas son tres variables diferentes.
print(saldo) print(Saldo) print(SALDO)
Resultado:
1000 2000 3000
Para variables normales utilizaremos minúsculas:
saldo = 1000 5.32 Evitar tildes y ñ
Python moderno permite muchos caracteres, pero es recomendable evitar tildes y ñ en los nombres.
Evita:
año_actual = 2026 categoría = "Comida"
Prefiere:
anio_actual = 2026 categoria = "Comida"
Dentro de los textos sí puedes escribirlos normalmente:
categoria = "Alimentación" 5.33 No utilizar palabras reservadas
Python utiliza algunas palabras para su propia sintaxis.
Por ejemplo:
if else for while def class return True False None
No pueden utilizarse como nombres de variables.
Incorrecto:
class = "Finanzas" if = 10
VS Code normalmente resaltará estas palabras con un color especial.
5.34 Nombres demasiado largos
Los nombres deben ser claros, pero no absurdamente largos.
Difícil de leer:
cantidad_total_de_dinero_disponible_en_la_cuenta_principal = 1000
Mejor:
saldo_principal = 1000
Busca un equilibrio entre claridad y sencillez.
5.35 Nombres engañosos
Este nombre es técnicamente válido:
nombre_usuario = 1500
Pero es confuso porque parece que debería contener un nombre.
Mejor:
total_ingresos = 1500
El nombre debe coincidir con el propósito del dato.