El arte de nombrar variables
El código se lee mucho más de lo que se escribe. Y sin embargo, seguimos nombrando variables como si fueran apuntes personales que nadie más va a leer.
El concepto en una frase
Nombrar variables es comunicación: cada nombre es una oportunidad de explicar tu intención a quien lea el código después.
La diferencia entre código y literatura
// ❌ Código críptico
const d = new Date();
const u = users.filter(x => x.a > 18);
const calc = (p, t) => p * 0.1 * t;
// ✅ Código que comunica
const currentDate = new Date();
const adultUsers = users.filter(user => user.age > 18);
const calculateInterest = (principal, timeInYears) =>
principal * 0.1 * timeInYears;
Analogía: Variables como etiquetas
Imagina tu código como una cocina profesional. Cada ingrediente (variable) necesita una etiqueta clara:
- •❌ "Cosa blanca en frasco"
- •✅ "Sal marina fina - Cocina principal"
Lo esencial que recordar
- •Usa nombres que revelen intención -
isUserLoggedIn
vsflag
- •Evita abreviaciones innecesarias -
userName
vsusrNm
- •Sé consistente en el proyecto - Si usas
getUserData
, no mezcles confetchUserInfo
- •Los nombres largos están bien - Mejor
calculateMonthlyPayment
quecalc
Mini-quiz
¿Cuál es mejor nombre para una función que valida emails?
- •[ ]
validate()
- •[ ]
checkEmail()
- •[x]
isValidEmail()