Quando usar camelCase
camelCase é compacto, como userProfileImage, e combina com ecossistemas que já o usam em variáveis e propriedades.
Guia de convenções de nomenclatura
camelCase vs snake_case
camelCase remove separadores e capitaliza palavras posteriores; snake_case mantém palavras minúsculas separadas por underscores. A melhor escolha depende da linguagem, API ou banco.
Comparação rápida
| Diferença | camelCase | snake_case |
|---|---|---|
| Exemplo | userProfileImage | user_profile_image |
| Uso comum | Identificadores JavaScript/TypeScript e muitas propriedades no estilo Java | Identificadores Python, colunas de banco, pipelines e configuração |
| Separador de palavras | Nenhum | Underscore (_) |
| Capitalização | Primeira palavra minúscula; seguintes capitalizadas | Normalmente tudo minúsculo |
| Exemplo com sigla | apiResponseUrl | api_response_url |
| Fronteira típica | Frontend / modelo da aplicação | Backend / API / campo de banco |
Quando usar snake_case
snake_case deixa os limites das palavras visíveis, como user_profile_image, e é comum em Python, SQL, dados e APIs.
Matriz de decisão
| Contexto | Convenção recomendada | Por quê |
|---|---|---|
| Código de aplicação JavaScript ou TypeScript | camelCase | Variáveis, parâmetros, métodos e propriedades normalmente usam lower camel case no ecossistema JavaScript. |
| Código de aplicação Python | snake_case | A PEP 8 recomenda nomes em minúsculas com underscores para funções e variáveis. |
| Fronteira JSON ou API HTTP | Seguir o contrato da API | Mantenha uma única convenção interna e normalize apenas uma vez na fronteira de serialização ou transporte. |
| Schema de banco de dados ou analytics existente | Seguir o schema existente | Alterar um contrato externo maduro costuma custar mais do que adaptar os dados na fronteira da aplicação. |
Qual estilo de nomenclatura escolher?
Use a convenção esperada pela camada. Um frontend JavaScript pode normalizar uma API snake_case na fronteira; consistência dentro de cada camada é mais importante.
Erros comuns a evitar
- Não presuma que acrônimos tenham uma única grafia correta: userID, userId e user_id aparecem em sistemas reais.
- Não misture dados snake_case brutos da API e dados camelCase normalizados no mesmo modelo ou cache key.
- Não renomeie recursivamente instâncias de classe, arquivos, streams ou outros valores não JSON como se fossem plain objects.
Converter entre estilos de nomenclatura
Cole um identificador para ver o formato alvo e os estilos compatíveis. A conversão roda localmente no navegador.
Detectado: snake_case
Saída snake_case
user_profile_image_url
Todos os formatos de nomenclatura
camelCase
userProfileImageUrlPascalCase
UserProfileImageUrlsnake_case
user_profile_image_urlkebab-case
user-profile-image-urlCONSTANT_CASE
USER_PROFILE_IMAGE_URLdot.case
user.profile.image.urlpath/case
user/profile/image/urlA conversão acontece localmente no navegador. Sua entrada não é enviada a um servidor de conversão.