Uso de convenciones de estilo
Un código consistente es más fácil de leer y mantener. Herramientas como Prettier y ESLint ayudan a mantener un formato uniforme.
1. Principales Estilos de Nomenclatura #
CamelCase #
- Descripción: Las palabras se escriben juntas, y cada palabra (excepto la primera) comienza con una mayúscula.
- Ejemplo:
miVariableEjemplo,calcularAreaRectangulo
- Ejemplo:
- Uso común:
- Variables y funciones en lenguajes como JavaScript, Java, Python y TypeScript.
- Ventaja: Es compacto y sigue las convenciones de la mayoría de lenguajes modernos.
PascalCase #
- Descripción: Similar a CamelCase, pero la primera palabra también comienza con una mayúscula.
- Ejemplo:
MiClaseEjemplo,CalcularArea
- Ejemplo:
- Uso común:
- Nombres de clases y constructores en lenguajes como Java, C#, TypeScript y Python.
- Ventaja: Diferencia claramente clases de variables y funciones.
SnakeCase #
- Descripción: Las palabras se separan con guiones bajos (
_) y suelen estar en minúsculas.- Ejemplo:
mi_variable_ejemplo,calcular_area
- Ejemplo:
- Uso común:
- Variables y funciones en Python, nombres de constantes en Java y C (
MAX_VALUE).
- Variables y funciones en Python, nombres de constantes en Java y C (
- Ventaja: Es fácil de leer y común en lenguajes que no diferencian entre mayúsculas y minúsculas.
Kebab-Case #
- Descripción: Similar a Snake_Case, pero las palabras se separan con guiones (
-).- Ejemplo:
mi-variable-ejemplo,calcular-area
- Ejemplo:
- Uso común:
- Nombres de archivos y atributos CSS.
- Ventaja: Es legible en contextos como HTML o configuraciones donde los guiones son estándar.
SCREAMINGSNAKECASE #
- Descripción: Variante de Snake_Case donde todo está en mayúsculas.
- Ejemplo:
MI_CONSTANTE_EJEMPLO,MAX_VALOR
- Ejemplo:
- Uso común:
- Constantes en lenguajes como Java, C, y Python.
- Ventaja: Hace que las constantes sean fáciles de identificar visualmente.
Train-Case (Pascal-Kebab-Case) #
- Descripción: Similar a Kebab-Case, pero las palabras comienzan con mayúscula.
- Ejemplo:
Mi-Variable-Ejemplo,Calcular-Area
- Ejemplo:
- Uso común:
- Menos común, pero a veces utilizado en configuraciones específicas o en casos estilísticos.
2. Importancia de Aplicarlo Según el Lenguaje #
Cada lenguaje tiene convenciones específicas para los estilos de nomenclatura. Seguir estas convenciones:
- Mejora la Legibilidad: Los desarrolladores familiarizados con el lenguaje entienden inmediatamente el propósito de las variables, funciones o clases.
- Facilita la Mantenibilidad: Un código consistente reduce errores y hace que sea más fácil trabajar en equipo.
- Previene Confusiones: Nombres inconsistentes pueden confundir, especialmente en proyectos grandes.
- Cumple con Estándares de la Industria: Las herramientas de análisis estático y revisión de código suelen exigir estilos consistentes.
Ejemplo de Código Malo:
Cargando actividad al acercarte…
3. Ejemplo Corregido #
Problema: Falta de espacios adecuados y formato inconsistente.
Solución: Usar herramientas automáticas asegura un formato uniforme y profesional.
- Sangría y Espacios: Se agregó sangría y separación adecuada en todos los lenguajes para mejorar la legibilidad.
- Nombres de Clases y Variables: Se usaron nombres descriptivos y convenciones específicas de cada lenguaje (PascalCase para clases en Java, camelCase para variables).
- Consistencia: Uso de un formato uniforme para bloques de código, paréntesis, y operadores en cada ejemplo.
- Mejor Legibilidad: Cada ejemplo ahora es claro, fácil de leer y sigue las mejores prácticas para su respectivo lenguaje.
Cargando actividad al acercarte…
Resumen del tema
Conceptos clave #
- Convenciones Idiomáticas: respetar los estándares de cada ecosistema (
camelCaseen JS/TS/Java,snake_caseen Python,PascalCasepara clases). - Formateo y Espaciado Consistente: mantener indentación uniforme y espacios alrededor de operadores para facilitar la lectura visual.
- Uso de Linters y Formateadores: automatizar la consistencia estilística del equipo mediante herramientas como ESLint, Prettier, Black o Checkstyle.
Qué debes recordar #
La consistencia en las convenciones de estilo reduce la fricción en revisiones de código y permite centrarse en la lógica del negocio.