Cómo nombrar variables: Guía para código limpio y legible

Nombrar variables es la decisión de diseño más frecuente que toma un programador. Buenos nombres hacen el código autodocumentado; malos nombres obligan a los lectores a descifrar tu lógica.

Principios fundamentales

• Revelar la intención: elapsedTimeInDays no d
• Evitar desinformación: No llames accountList a algo que en realidad es un set
• Usar nombres pronunciables: generationTimestamp no genymdhms
• Usar nombres buscables: MAX_STUDENTS_PER_CLASS no 7

Patrones de nombres por tipo

Tipo	Patrón	Ejemplos
Boolean	is/has/can/should + adjetivo	isActive, hasPermission
Contador	sustantivo + Count/Total	retryCount, totalItems
Colección	Sustantivo en plural	users, selectedItems
Función	verbo + sustantivo	calculateTotal, fetchUser
Event handler	handle/on + evento	handleClick, onSubmit

Antipatrones

• data, info, temp, stuff — demasiado vagos
• a, b, x — aceptables solo en lambdas y fórmulas matemáticas
• flag — ¿flag de qué? Usa isEnabled en su lugar
• Notación húngara (strName, intAge) — obsoleta con IDEs modernos

Formatea tus nombres

Usa el conversor camelCase para variables JavaScript, el conversor snake_case para Python, o el hub de conversión de case.