Cómo hacer buenos nombres de variables

Al compilador o intérprete, por supuesto, no le importan los nombres de variables, por lo tanto, tenga en cuenta que el propósito de un nombre de variable es ser leído por personas . Usted elige buenos nombres de variables al enfocarse en quién lo leerá. Si el código es un proyecto personal que nunca espera mostrar a nadie más, elija un nombre que le recuerde su propósito. Pero para la mayoría de los códigos, debe elegir un nombre que indique su propósito a otra persona.

Apéguese a las convenciones del lenguaje y el proyecto en el que está trabajando, como UsingCamelCase vs. separating_words_with_underscores. Intenta comprometerte lo mejor que puedas entre algo descriptivo y algo breve. A menudo, los nombres de las variables son frases, y a menudo se puede reformular para que sea razonablemente breve sin sacrificar la comprensión, por ejemplo, utilizando el subrayado_separado en lugar de separado_con_colecciones.

Se consistente. Si usa “mayor” como parte de un nombre de variable en un lugar, úselo de manera coherente, en lugar de decir “mayor” y otras veces “máximo”.

Primero, definamos “bueno”. ¿Bueno para qué? ¿En qué tipo de programa? ¿Quién lo leerá? ¿Cuando? Eso se usará por cuánto tiempo y por cuántos. Y tendrá que ir a través de los idiomas (por ejemplo, el uso de R y SAS. Para diferentes propósitos).

Y, para ver un ejemplo hilarante de lo que no debe hacer, consulte Programación para la seguridad laboral. , particularmente la sección sobre convenciones de nomenclatura que comienza en la pág. 6 6

La mayoría de los idiomas tienen sus propias guías de estilo, generalmente los nombres cortos y descriptivos son los mejores. Lo suficientemente corto como para no ser difícil de manejar, lo suficientemente descriptivo como para que alguien que lo lea tenga una idea de lo que representa.