5 minutos de leitura
Autor(a)
Akemi faz parte do Scuba Team na Escola de Programação & DevOps da Alura, com foco em Java, e é técnica em Informática pelo Instituto Federal de São Paulo (IFSP).
Fique por dentro de conteúdos, insights e oportunidades do universo tech. Receba novidades e lançamentos direto no seu e-mail.
Quem estuda programação frequentemente precisa nomear variáveis, classes, métodos, funções e outros elementos. Mas será que existem convenções para tornar esse processo mais simples e organizado?
Entenda neste artigo as principais convenções de nomenclatura (Camel, Pascal, Kebab e Snake case), seus usos e exemplos práticos em diferentes linguagens de programação.
Aplicar boas práticas no código inclui adotar convenções de nomenclatura como camel case, snake case, pascal case e kebab case, que são recomendações para nomear identificadores de maneira organizada.
Essas convenções tornam o código mais limpo, fácil de entender e mantêm um padrão que pode indicar a função do identificador.
Além disso, podemos encontrar outras linguagens, como Go, que dependem muito de você conhecer a diferença entre os casos de uso, pois a convenção utilizada no nome possui um efeito semântico também.
Agora, vamos conhecer os quatro tipos mais comuns de convenções de nomenclatura, também chamadas de string cases, muito utilizadas em programação. Vamos lá?
No camel case, a primeira palavra começa com letra minúscula e as palavras seguintes iniciam com letra maiúscula:
coisasParaFazer
idadeDoAmigo
valorFinal
O Pascal case, também chamado de “Upper Camel Case” ou “Capital Case”, consiste em unir palavras onde cada uma inicia com letra maiúscula:
CoisasParaFazer
IdadeDoAmigo
ValorFinalNo snake case, também chamado de “underscore case”, utilizamos o caractere underline para separar as palavras. Quando os nomes estão todos em maiúsculas, essa convenção passa a ser chamada de “screaming snake case”:
coisas_para_fazer
idade_do_amigo
valor_final
PRIMEIRO_NOME
LISTA_INICIALEm kebab case, as palavras são separadas por hífens. Quando todo o texto está em maiúsculas, é chamado de “screaming kebab case:
coisas-para-fazer
idade-do-amigo
valor-final
PRIMEIRO-NOME
LISTA-INICIALO Java conta com o "Java Secure Coding Guidelines", documentação fornecida pela Oracle e baseada no "Java Language Specification". Vale ressaltar que as convenções sugeridas datam de 1999 e podem não refletir todas as práticas atuais. Entre as convenções mais recorrentes estão:
public class Pessoa{
public static void main(String[] args) {
String primeiroNome = "Maria";
int idade = 22;
double alturaAtual = 1.65;
final String MENSAGEM_PADRAO = "Olá";
}
}class ClienteBanco {
constructor(primeiroNome, cpf) {
this.primeiroNome = primeiroNome;
this.cpf = cpf;
}
exibirPrimeiroNome(){
console.log(this.primeiroNome);
}
}
var clienteUm = new ClienteBanco('Maria', 150);
var clienteDois = new ClienteBanco('João', 70);O Python possui um guia de estilos e estruturação que fornece convenções de codificação para o código, o PEP8. Isso não significa que seu código não funcionará se não seguir as diretrizes, no entanto, segundo o PEP 20 -- The Zen of Python, a legibilidade conta.
class Pessoa:
def __init__(self, nome, cpf):
self.nome = nome
self.cpf = cpf
def exibir_primeiro_nome(self):
print(self.nome)
pessoa_um = Pessoa('Alice', '123456789')Os nomes na linguagem Go tem um efeito semântico, a visibilidade de um identificador fora de um pacote é determinada se o nome inicia com letra maiúscula ou minúscula, portanto devemos nos atentar com as convenções utilizadas.
O Go também possui uma documentação com ótimas dicas para escrever um código claro, o Effective Go.
package nome
type ExportedStruct {
unexportedField string
}A linguagem Ruby utiliza o Ruby Style Guide, um guia de estilo que te dá boas dicas para a escrita do código.
class Pessoa
def initialize(primeiro_nome, cpf)
@primeiro_nome = primeiro_nome
@cpf = cpf
end
def exibe_primeiro_nome
@primeiro_nome
end
end
pessoa_um = Pessoa.new('Alice', 123456789)Para auxiliar, confira essa tabela que mostra as principais convenções de nomenclatura que abordamos nessa leitura.
| Convenção | Exemplo |
| Camel case | primeiroNomePessoa |
| Pascal case | PrimeiroNomePessoa |
| Snake case | primeiro_nome_pessoa |
| Screaming snake case | PRIMEIRO_NOME_PESSOA |
| Kebab case | primeiro-nome-pessoa |
| Screaming kebab case | PRIMEIRO-NOME-PESSOA |
Ao longo deste artigo, foi possível observar que cada linguagem adota suas próprias convenções de nomenclatura. Muitas empresas e comunidades também definem padrões específicos, como o Google, que usa os Google Style Guides como referência para projetos de código aberto.
As características de cada linguagem de programação podem tornar determinadas convenções mais apropriadas em alguns contextos. Por isso, é importante ficar atento às recomendações do projeto e manter consistência no padrão escolhido.
Dominar convenções de nomenclatura pode parecer um detalhe pequeno, mas é exatamente esse tipo de cuidado que separa quem apenas escreve código de quem constrói software de verdade.
À medida que você evolui na programação, clareza, padronização e legibilidade deixam de ser “boas práticas” e passam a ser essenciais para trabalhar em equipe, manter código escalável e crescer na carreira.
Se você quer construir essa base do jeito certo desde o início, entendendo não só como programar, mas como escrever código limpo e profissional, o próximo passo é investir na sua formação.
Pronto pra sair do básico e começar com o pé direito? Conheça a Formação Iniciante em Programação da Alura e desenvolva fundamentos que vão te acompanhar em toda a sua jornada como dev.
• Formação Java e Orientação a Objetos
• Formação JavaScript para back-end
Avalie este artigo
Python: Qual a diferença entre == e is?
Ler mais
Django: Configurando hora e idioma
Ler mais
Django: o que é, para que serve e um Guia desse framework Python
Ler mais