Ir para o conteúdo
TextArray

camelCase, snake_case, kebab-case: um guia de nomenclatura para desenvolvedores

Blog /

Ao nomear variáveis, funções, classes ou URLs, o formato escolhido é importante. Diferentes linguagens e contextos têm convenções diferentes: JavaScript usa camelCase, Python prefere Snake_case, propriedades CSS usam kebab-case e constantes de configuração usam CONSTANT_CASE. Compreender cada um deles e saber como converter entre eles é uma habilidade prática que mantém seu código consistente e legível.

camelCase: o padrão JavaScript

camelCase começa com uma letra minúscula e coloca a primeira letra de cada palavra subsequente em maiúscula, sem separadores. Variáveis e nomes de funções em JavaScript seguem este padrão: getUserById, calculateTotalPrice, handleSubmitClick. A maioria das chaves JSON também são camelCase por convenção.

O nome vem das “protuberâncias” que as letras maiúsculas criam. É compacto, legível e o padrão de fato em JavaScript, TypeScript, Java e C#. Quando você precisar converter texto em camelCase — seja construindo um gerador de código ou padronizando nomes de variáveis — o conversor de caso lida com isso em uma pasta.

Snake_case: Python e bancos de dados

Snake_case junta palavras com sublinhados e mantém todas as letras minúsculas: get_user_by_id, calculate_total_price, handle_submit_click. Os desenvolvedores Python usam isso para nomes de variáveis e funções, de acordo com as diretrizes de estilo PEP 8. Os nomes de colunas e tabelas SQL também costumam usar Snake_case, assim como variáveis de ambiente na maioria dos sistemas.

Snake_case é legível mesmo em letras maiúsculas (DATABASE_PASSWORD, MAX_RETRY_COUNT), e é por isso que CONSTANT_CASE — Snake_case maiúsculo — é a convenção universal para constantes de configuração e variáveis finais em todas as linguagens.

caso kebab: URLs e CSS

kebab-case une palavras com hífens e usa todas as letras minúsculas: get-user-by-id, calculate-total-price. Você vê isso em todos os lugares em URLs – artigos slugs, páginas de produtos, nomes de rotas – porque os hífens são amigáveis para os mecanismos de pesquisa e têm menos probabilidade de serem mal interpretados pelos analisadores do que os sublinhados. Nomes de classes CSS e atributos HTML personalizados também usam kebab-case por convenção.

Construir identificadores seguros para URL ou nomes semelhantes a slug a partir de texto simples é um dos usos mais práticos. O Gerador slug converte frases em strings kebab-case prontas para URL, eliminando pontuação e acentos ao longo do caminho.

PascalCase: classes e tipos

PascalCase (ou UpperCamelCase) coloca a primeira letra em maiúscula: GetUserById, CalculateTotalPrice. É a convenção para nomes de classes, definições de tipos e componentes em TypeScript, C#, Java e React. Ao trabalhar com linguagens orientadas a objetos ou estruturas de componentes, é isso que você buscará.

Convertendo entre formatos

A conversão de uma convenção para outra requer dois passos: primeiro dividir o identificador em palavras separadas, então juntar-se novamente com o separador de alvo e o invólucro. É aí que as ferramentas agilizam o processo.

Se você possui um identificador camelCase e precisa entender suas partes – talvez para renomeá-lo ou corresponder a uma versão do snake_case – o camelo divididoCase ferramenta separa tudo: getUserById torna-se get User By Id. Uma vez separadas as palavras, o conversor de caso pode reformatá-los em qualquer convenção que você precisar. Os desenvolvedores também usam essas ferramentas ao refatorar código além dos limites da linguagem ou ao traduzir entre especificações de API e nomes de variáveis internas.

Quando usar cada convenção

A escolha certa depende do contexto, não da preferência. JavaScript e JSON usam camelCase. Python, SQL e variáveis de ambiente usam Snake_case. URLs e CSS usam kebab-case. Os nomes de tipo e classe usam PascalCase. As constantes de configuração usam CONSTANT_CASE em todos os idiomas. Seguir essas convenções torna seu código instantaneamente reconhecível por qualquer pessoa familiarizada com esse ecossistema.

A consistência é mais importante do que a convenção específica – se você misturar formatos no mesmo arquivo ou projeto, os leitores terão que mudar de contexto e os erros se tornarão mais fáceis. Ferramentas para converter e dividir identificadores ajudam você a manter a consistência ao trabalhar em vários idiomas ou migrar código entre projetos.