Convenciones de nombres en programación: Guía completa
Las convenciones de nombres son reglas sistemáticas para elegir identificadores en el código fuente. Usar la convención correcta mejora la legibilidad, reduce bugs y facilita el mantenimiento entre equipos.
Por qué importan las convenciones
El código se lee mucho más de lo que se escribe. Una nomenclatura consistente permite a los desarrolladores entender el propósito y alcance de una variable, función o clase de un vistazo.
Las principales convenciones
camelCase
Palabras unidas sin separador, mayúscula desde la segunda: getUserName, totalPrice. Estándar para variables y funciones en JavaScript, TypeScript, Java y Swift.
PascalCase (UpperCamelCase)
Como camelCase pero la primera también en mayúscula: UserAccount, HttpClient. Para nombres de clases, componentes React e interfaces TypeScript.
snake_case
Guiones bajos como separador, todo en minúsculas: user_name, get_total_price. Mandado por PEP 8 para Python, también estándar en Ruby, Rust y SQL.
SCREAMING_SNAKE_CASE
Todo en mayúsculas con guiones bajos: MAX_RETRY_COUNT, API_BASE_URL. Para constantes y variables de entorno.
kebab-case
Guiones como separador, todo en minúsculas: my-component, user-profile. Estándar en clases CSS, atributos HTML, slugs de URL y flags CLI.
Convención por lenguaje
| Lenguaje | Variables/Funciones | Clases | Constantes |
|---|---|---|---|
| JavaScript / TypeScript | camelCase | PascalCase | SCREAMING_SNAKE |
| Python | snake_case | PascalCase | SCREAMING_SNAKE |
| Java | camelCase | PascalCase | SCREAMING_SNAKE |
| Ruby | snake_case | PascalCase | SCREAMING_SNAKE |
| Rust | snake_case | PascalCase | SCREAMING_SNAKE |
| Go | camelCase | PascalCase | camelCase / PascalCase |
| C# | camelCase | PascalCase | PascalCase |
| Swift | camelCase | PascalCase | camelCase |
| PHP | camelCase / snake_case | PascalCase | SCREAMING_SNAKE |
| CSS | kebab-case | — | — |
Mejores prácticas
- Sigue la guía de estilo de tu lenguaje. PEP 8 para Python, Google Style para Java, Airbnb para JavaScript — no inventes tus propias reglas.
- Sé consistente dentro del proyecto. Mezclar camelCase y snake_case en el mismo archivo confunde a todos.
- Usa nombres descriptivos.
getUserByIden lugar degetU. La convención es el formato; el contenido debe ser significativo. - Evita abreviaciones.
calculateTotalPriceen lugar decalcTotPrc. - Adáptate al ecosistema. Si tu proyecto React usa props en camelCase pero tu API Python devuelve snake_case, convierte en la frontera.
Conclusión
Las convenciones de nombres no son arbitrarias. Codifican información sobre alcance, tipo e intención. Aprende el estándar de tu lenguaje, aplícalo consistentemente, y tu código será más fácil de leer, revisar y mantener.
Convertir entre convenciones
Usa nuestro conversor camelCase, conversor snake_case, conversor PascalCase o conversor kebab-case. O prueba el hub de conversión de case para comparar todos los formatos.