Intermedio

El arte de nombrar variables

Diego Argueta
8 de enero de 2024
8 min
0% leído

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

  1. Usa nombres que revelen intención - isUserLoggedIn vs flag
  2. Evita abreviaciones innecesarias - userName vs usrNm
  3. Sé consistente en el proyecto - Si usas getUserData, no mezcles con fetchUserInfo
  4. Los nombres largos están bien - Mejor calculateMonthlyPayment que calc

Mini-quiz

¿Cuál es mejor nombre para una función que valida emails?

  • [ ] validate()
  • [ ] checkEmail()
  • [x] isValidEmail()

Explícalo en un tuit

Según el principio de Feynman, si puedes explicar algo de forma simple, realmente lo entiendes. Escribe tu resumen en 280 caracteres:

0/280