Tokens_identifiers - glantucan/puzzle_game GitHub Wiki

Recomendaciones para la creación de identificadores

La importancia de ponerle nombre a las cosas

El nombre de una variable no es fundamental para que el programa funcione, pero sí para que cuando vuelvas a leer esa parte del programa, tú mismo entiendas lo que hiciste.

En programas sencillos puede parecer absurdo dedicar siquiera unos segundos a pensar el nombre de una variable, pero a medida que la cantidad de código crece y la distancia entre el lugar en el que definimos la variable y los lugares en los que la usamos se alarga, esos segundos son fundamentales.

Si no se han invertido esos segundos en poner nombres descriptivos, se pueden convertir en minutos o incluso horas (no exagero) de pérdida de tiempo si hemos puesto nombres confusos o sin significado alguno.

En general es preferible poner un nombre compuesto y largo si no se nos ocurre uno más corto. Lo importante no es tardar menos en escribir, lo importante es tardar menos en comprender y pensar. Te recuerdo que el 90% del tiempo que se pasa delante de un programa se pasa pensando, no escribiendo.

Mayúsculas y minúsculas en los identificadores

Como llegado cierto punto es habitual que nos se nos ocurran nombres cortos y simples para nuestros identificadores y acabamos utilizando palabras compuestas para ellos, los programadores han desarrollado ciertas constubres para separar esas palabras, que además ayudan a distinguir de un vistazo si son variables, propiedades, funciones, etc.

Lo que sigue son criterios que se recomienda seguir. Aunque no sean reglas obligatorias te pido que las sigas, porque es lo que hace la inmensa mayoría de programadores, aumenta la legibilidad de los programas y permite distinguir de un vistazo si el identificador se refiere a una propiedad, una variable local, una función o una clase.

Para variables locales y propiedades

Por norma general se utiliza la denominada notación camelCase, para identificadores de variables locales y propiedades. Esto quiere decir que la primera letra de la palabra se escribe en minúsculas. Si el identificador consta de varias palabras se empieza la primera con minúscula y las siguientes con mayúscula. El resto de los caracteres del identificador se dejan con minúscula. Esto facilita su lectura. Ejemplos: targetPosition, playerVelocity, enemyWeaponDetector, etc.

Para distinguir entre variables locales y propiedades de la clase acuerdate de utilizar this delante de las propiedades (this.weapon, this.gameObject)

Para nombres de función y clases

Si el identificador es el nombre de una clase o de una función, se utiliza la notación PascalCase, en la que la primera palabra siempre empieza con mayúscula y el resto como en la notación camelCase. Ejemplos: Update, Start, OnTriggerEnter, MonoBehaviour, PlayerController, Inventory, LevelLoader, … La anterior es la convención que se utiliza en la mayoría de los lenguajes y la que te recomiendo que utilices para tus identificadores, porque ayuda a no confundir las clases y tipos de las variables y las funciones. Desafortunadamente las librerías de C# y Unity no la siguen siempre y tendrás tener cuidado para no olvidar qué va con minúscula y qué va con mayúscula, cuando uses sus variables y funciones predefinidas. Cuidado. C# es sensible a mayúsculas y minúsculas, lo que significa que para el compilador enemies y Enemies son dos identificadores distintos.

⚠️ **GitHub.com Fallback** ⚠️