Nombre Significativos
Los nombres significativos son la base del código limpio. Usar nombres claros para variables, funciones y clases facilita que otros desarrolladores (y tú mismo en el futuro) entiendan qué hace el código.
1. Nombres de Variables, Funciones y Clases #
Ejemplo Malo:
Ejemplo Bueno:
Problema: Los nombres no aportan contexto. ¿Qué significa
xoy?
Solución: Los nombres ahora describen claramente lo que representan, eliminando la ambigüedad.
2. Nombres genéricos #
Genéricos: Evita nombres como
data,info,temp, que no aportan contexto.
Siglas sin sentido: Abreviaturas como
usren lugar deusuariopueden ser confusas.
Ejemplo Malo:
Ejemplo Bueno:
Problema: Un nombre genérico como
calcno describe su propósito.
Solución: Un nombre descriptivo como
calcularPromedioindica claramente la función del código.
3. Tampoco hay que pasarse con hacerlos demasiado largos #
Resumen del tema
Conceptos clave #
- Intención Clara: los nombres de variables, funciones y clases deben revelar su propósito sin necesidad de comentarios explicativos.
- Evitar Nombres Genéricos y Abreviaturas: huir de identificadores vagos como
data,temp,infoo siglas crípticas comousr. - Equilibrio y Concisión: buscar la longitud justa; evitar nombres excesivamente largos o redundantes que añadan ruido sin aportar valor semántico.
- Vocabulario Consistente: usar los mismos términos para los mismos conceptos en todo el proyecto (por ejemplo, no mezclar
getUser,fetchCustomeryretrieveClient).
Qué debes recordar #
Un buen nombre revela la intención, responde al por qué existe y hace que el código se lea como prosa comprensible.