Imagina que vuelves a tu código dentro de un mes… o que lo lee otra persona… Y no entienden qué hace cada variable. 😭
Los nombres de las variables juegan un papel clave en eso. En esta lección vas a aprender cómo elegir buenos nombres y evitar un problema muy común llamado números mágicos. 🔮
La importancia de los nombres
let x = 'Códica!';
console.log(x);
console.log(x);
Este código funciona sin problemas, pero hay un detalle: la variable se llama x. Esto está bien para matemáticas o ejemplos simples, pero en programas reales confunde. Es mejor darle un nombre que diga qué almacena.
Como programadores, leemos código mucho más de lo que lo escribimos, y un nombre claro puede hacer toda la diferencia.
En la mayoría de los proyectos reales se usa inglés, y eso te ayudará a estar más preparado para trabajar con otros programadores o entrar al mercado laboral.
Estilos de nomenclatura
A veces, los nombres de variables contienen más de una palabra, y hay diferentes formas de escribirlos. Estas son algunas convenciones comunes:
| Nomenclatura | Ejemplo | Característica |
|---|---|---|
| 🥙 kebab-case | my-super-var |
Usa guiones entre palabras |
| 🐍 snake_case | my_super_var |
Usa guiones bajos |
| 🐫 CamelCase | MySuperVar |
Mayúscula en cada palabra |
| 🐫 lowerCamelCase | mySuperVar |
Igual a CamelCase, pero con la primera en minúscula |
En JavaScript, se recomienda usar lowerCamelCase, la primera palabra empieza con minúscula y las siguientes con mayúscula.
let userName = 'Carlos'; // Correcto en JavaScript
let mySuperVariable = 25; // Correcto en JavaScript
Números mágicos
Este código funciona, pero hay un problema:
let dollarsCount = 50 * 1.25; // 62.5
let copCount = dollarsCount * 4000; // 250000
console.log(copCount);
❓ ¿Qué significan 1.25, 50 y 4000? A simple vista, no está claro.
✅ Solución: Usar variables con nombres claros ayuda a que el código sea más fácil de entender y modificar.
Para mejorar la claridad, podemos reemplazar estos números mágicos con variables bien nombradas:
let dollarsPerEuro = 1.25; // Tasa de cambio de euros a dólares
let copPerDollar = 4000; // Tasa de conversión de dólares a pesos colombianos
let dollarsCount = 50 * dollarsPerEuro; // 62.5 dólares
let copCount = dollarsCount * copPerDollar; // 250000 pesos
console.log(copCount);
Beneficios de esta versión:
- Ahora entendemos lo que representan los valores.
- El código sigue normas de
lowerCamelCase. - Agregamos espacios en blanco para mejorar la legibilidad.
- Aunque es más largo, es mucho más claro, lo que evita errores en el futuro.
Resumen
- Elige nombres de variables descriptivos para mejorar la legibilidad.
- Usa lowerCamelCase en JavaScript (
nombreDeUsuarioen vez denombre_usuarioonombre-usuario). - Evita los números mágicos: reemplázalos con variables con nombres claros.
- Un código claro es mejor que un código corto. La legibilidad es clave.
Siguiendo estas buenas prácticas, nuestro código será más fácil de entender y mantener con el tiempo.
Materiales adicionales
Para acceder completo a curso necesitas un plan básico
El plan básico te dará acceso completo a todos los cursos, ejercicios y lecciones de Códica, proyectos y acceso de por vida a la teoría de las lecciones completadas. La suscripción se puede cancelar en cualquier momento.