SlugGenerator.app

Convenções de nomes na programação: Guia completo

7 min de leitura

Convenções de nomes são regras sistemáticas para escolher identificadores no código-fonte. Usar a convenção correta melhora a legibilidade, reduz bugs e facilita a manutenção entre equipes.

Por que as convenções importam

Código é lido muito mais vezes do que é escrito. Nomenclatura consistente permite que os desenvolvedores entendam o propósito e escopo de uma variável, função ou classe de relance.

As principais convenções

camelCase

Palavras unidas sem separador, maiúscula a partir da segunda: getUserName, totalPrice. Padrão para variáveis e funções em JavaScript, TypeScript, Java e Swift.

PascalCase (UpperCamelCase)

Como camelCase mas a primeira também em maiúscula: UserAccount, HttpClient. Para nomes de classes, componentes React e interfaces TypeScript.

snake_case

Underscores como separador, tudo em minúsculas: user_name, get_total_price. Mandado pelo PEP 8 para Python, também padrão em Ruby, Rust e SQL.

SCREAMING_SNAKE_CASE

Tudo em maiúsculas com underscores: MAX_RETRY_COUNT, API_BASE_URL. Para constantes e variáveis de ambiente.

kebab-case

Hifens como separador, tudo em minúsculas: my-component, user-profile. Padrão em classes CSS, atributos HTML, slugs de URL e flags CLI.

Convenção por linguagem

LinguagemVariáveis/FunçõesClassesConstantes
JavaScript / TypeScriptcamelCasePascalCaseSCREAMING_SNAKE
Pythonsnake_casePascalCaseSCREAMING_SNAKE
JavacamelCasePascalCaseSCREAMING_SNAKE
Rubysnake_casePascalCaseSCREAMING_SNAKE
Rustsnake_casePascalCaseSCREAMING_SNAKE
GocamelCasePascalCasecamelCase / PascalCase
C#camelCasePascalCasePascalCase
SwiftcamelCasePascalCasecamelCase
PHPcamelCase / snake_casePascalCaseSCREAMING_SNAKE
CSSkebab-case——

Melhores práticas

  • Siga o guia de estilo da sua linguagem. PEP 8 para Python, Google Style para Java, Airbnb para JavaScript — não invente suas próprias regras.
  • Seja consistente dentro do projeto. Misturar camelCase e snake_case no mesmo arquivo confunde a todos.
  • Use nomes descritivos. getUserById em vez de getU. A convenção é o formato; o conteúdo deve ser significativo.
  • Evite abreviações. calculateTotalPrice em vez de calcTotPrc.
  • Adapte-se ao ecossistema. Se seu projeto React usa props em camelCase mas sua API Python retorna snake_case, converta na fronteira.

Conclusão

Convenções de nomes não são arbitrárias. Elas codificam informações sobre escopo, tipo e intenção. Aprenda o padrão da sua linguagem, aplique-o consistentemente, e seu código será mais fácil de ler, revisar e manter.

Converter entre convenções

Use o nosso conversor camelCase, conversor snake_case, conversor PascalCase ou conversor kebab-case. Ou experimente o hub de conversão de case para comparar todos os formatos.