Teoría: Nomenclatura

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.

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:

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.

Siguiendo estas buenas prácticas, nuestro código será más fácil de entender y mantener con el tiempo.