Saltar al contenido principal

C# Reglas - Campos y variables

  • Utiliza sustantivos para los nombres de las variables: Los nombres de las variables deben ser descriptivos, claros e inequívocos porque representan una cosa o un estado. Por lo tanto, utiliza un sustantivo para nombrarlas, excepto cuando la variable sea de tipo bool.
  • Prefija booleanos con un verbo: Estas variables indican un valor verdadero o falso. A menudo son la respuesta a una pregunta, como - ¿está corriendo el jugador? ¿Se ha acabado la partida? Añádeles un verbo para que su significado sea más evidente. A menudo van acompañadas de una descripción o condición, por ejemplo, isDead, isWalking, hasDamageMultiplier, etc.
  • Utiliza nombres significativos. No abrevies (a menos que se trate de matemáticas): Los nombres de sus variables revelarán su intención. Elige nombres fáciles de pronunciar y de buscar.
  • Las variables de una sola letra están bien para bucles y expresiones matemáticas, pero por lo demás, no abrevies. La claridad es más importante que el tiempo que te ahorras omitiendo algunas vocales.
  • Al crear prototipos rápidamente, puedes utilizar nombres "basura" cortos y refactorizarlos más tarde para que tengan sentido.
  • Utiliza pascal case para campos públicos y camel case para variables privadas. Como alternativa a los campos públicos, utiliza Properties.
  • Evita demasiados prefijos o codificaciones especiales: únicamente se tiene que anteponer un guión bajo (_) a las variables privadas para diferenciarlas de las variables locales.
  • Especifica (u omite) los modificadores de nivel de acceso (private, public, protected, etc. ) de forma coherente: Si omites el modificador de acceso, el compilador asumirá que el nivel de acceso es privado. Recuerda que es primordial la claridad y lectura del código, entonces no omitas los modificadores de acceso.
  • Utiliza una declaración de variable por línea. Es menos compacto, pero mejora la legibilidad.
  • Evita nombre redundantes: Si tu clase se llama Player, no necesitas crear variables tipo “PlayerScore” o “PlayerTarget”.
  • Evita los chistes o juegos de palabras: Aunque en el momento puedan darte risa, las variables tipo “infiniteMonkeys” o “dudeWheresMyChar”.
  • Usa la palabra clave “var” para variables locales implícitas (Si ayuda a la legibilidad y el tipo de variable es obvio).