Guía de convenciones de nombres para desarrolladores
Cómo nombras variables, funciones y archivos puede parecer una cuestión de gusto, pero en realidad es una regla que determina la productividad de tu equipo y la legibilidad de tu código.
Por qué importan las convenciones de nombres
El código se lee mucho más de lo que se escribe. Una convención de nombres coherente ayuda a los demás, y a tu yo del futuro, a entender el código con rapidez.
Cuando las reglas son uniformes, el nombre por sí solo insinúa si algo es una variable, una constante o una clase, reduciendo las búsquedas innecesarias.
Los principales formatos de un vistazo
- camelCase — primera palabra en minúscula, primera letra de las siguientes palabras en mayúscula (myVariableName)
- PascalCase — primera letra de cada palabra en mayúscula (MyClassName)
- snake_case — todo en minúscula, palabras unidas con guiones bajos (my_variable_name)
- CONSTANT_CASE — todo en mayúscula con guiones bajos, normalmente para constantes (MAX_COUNT)
- kebab-case — todo en minúscula con guiones, normalmente para URLs y CSS (my-class-name)
Convenciones según el lenguaje y el contexto
Muchos lenguajes recomiendan sus propias convenciones. Python prefiere snake_case para variables y funciones, JavaScript y Java usan camelCase, y la mayoría de los lenguajes usan PascalCase para los nombres de clase.
Las constantes se escriben a menudo en CONSTANT_CASE sin importar el lenguaje, y kebab-case es en la práctica el estándar para las rutas de URL y las clases de CSS.
La coherencia importa más que la regla
Ningún formato es absolutamente correcto. Lo más importante es seguir de forma coherente la regla que tu proyecto o tu equipo hayan acordado.
Al incorporarte a una base de código existente, prioriza sus convenciones por encima del gusto personal. Si necesitas renombrar muchos identificadores a la vez, un conversor de formatos ayuda.