¿camelCase, snake_case o kebab-case? Convenciones de nombres
Por Marcelo Torres · Publicado
En programación no se pueden usar espacios en los nombres, así que cada lenguaje ha adoptado una forma de unir palabras. Usar la adecuada hace el código más legible y evita sorpresas en URL y APIs. Aquí tienes una referencia práctica.
Los estilos principales
- camelCase: primera palabra en minúscula y el resto con mayúscula inicial (nombreUsuario).
- PascalCase: todas las palabras con mayúscula inicial (NombreUsuario).
- snake_case: palabras en minúscula unidas con guiones bajos (nombre_usuario).
- kebab-case: palabras en minúscula unidas con guiones (nombre-usuario).
- CONSTANT_CASE: palabras en mayúscula unidas con guiones bajos (NOMBRE_USUARIO).
El convertidor de mayúsculas y minúsculas transforma cualquier frase, o una lista de nombres, en todos estos estilos a la vez.
Por lenguaje de programación
- JavaScript y TypeScript: camelCase para variables y funciones, PascalCase para clases y componentes de React, y CONSTANT_CASE por convención para valores fijos.
- Python: snake_case para variables y funciones, PascalCase para clases y CONSTANT_CASE para constantes, como recomienda la guía de estilo PEP 8.
- Java y Kotlin: camelCase para métodos y variables, PascalCase para clases.
- C#: PascalCase para métodos, propiedades y clases; camelCase para variables locales y parámetros.
- Go: camelCase o PascalCase, y la primera letra importa: los nombres que empiezan por mayúscula se exportan del paquete.
- Ruby: snake_case para métodos y variables, PascalCase para clases y módulos.
En caso de duda, sigue el código existente o la guía de estilo oficial del lenguaje: la coherencia importa más que cualquier preferencia personal.
Fuera del código
- URL: kebab-case. Los guiones se leen con facilidad, y la propia guía de Google recomienda separar las palabras de las URL con guiones en lugar de guiones bajos.
- Clases CSS y atributos HTML: kebab-case (main-header, data-user-id).
- Variables de entorno: CONSTANT_CASE (DATABASE_URL).
- Tablas y columnas de bases de datos: snake_case es la convención más habitual, porque muchas bases de datos pasan a un mismo tipo de letra los nombres sin comillas.
- Nombres de archivo: kebab-case o snake_case evitan problemas entre sistemas operativos que tratan las mayúsculas de forma distinta.
JSON y APIs
JSON no impone un estilo para las claves. Las APIs pensadas sobre todo para JavaScript suelen usar camelCase ("nombreUsuario"), mientras que muchas otras usan snake_case ("nombre_usuario"). Elige un estilo para toda la API y documéntalo. Mezclar ambos en la misma respuesta es una fuente habitual de errores, fácil de detectar si formateas la respuesta con el formateador JSON.
Tildes y caracteres especiales
La mayoría de identificadores deberían usar solo letras y dígitos ASCII. Algunos lenguajes aceptan letras con tilde, pero muchas herramientas, bases de datos y URL no. Por eso el convertidor transforma configuración en configuracion en los estilos de programación y conserva las tildes en los de texto.