Saltar al contenido
toolzom

¿camelCase, snake_case o kebab-case? Convenciones de nombres

Por · 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.

Herramientas que se usan en esta guía