7.1.4 - Boas práticas e convenções da comunidade
🌟 Boas Práticas no Código: Programar com Estilo (e Clareza!)
🌟 Boas Práticas no Código: Programar com Estilo (e Clareza!)
Saber programar é importante. Mas saber programar de forma organizada e legível é o que te torna um dev de respeito! 😎 Aqui vão algumas boas práticas que a comunidade usa e valoriza — e que vão te ajudar a escrever códigos bonitos, claros e profissionais. ✨
🧠 Dê nomes claros para variáveis (e use camelCase)
Evite nomes como x
, coisa
, dados1
...
Use nomes que fazem sentido e ajudam a entender o que está acontecendo no código!
// Ruim ❌
let a = 10;
// Melhor ✅
let idadeUsuario = 10;
📚 O estilo de escrita camelCase
é esse aqui: começa com letra minúscula e toda nova palavra começa com maiúscula.
🟰 Use ===
ao invés de ==
===
ao invés de ==
No JavaScript, ==
compara valores, mas ignora o tipo (pode causar confusão).
O ===
compara valor e tipo, e é mais seguro!
console.log(1 == "1"); // true 😬
console.log(1 === "1"); // false ✅
📌 Dica: Sempre use ===
e !==
(o oposto de ===
) para evitar bugs invisíveis!
📐 Indente seu código direitinho!
Indentação é organizar o código com espaços e "degraus" pra mostrar o que está dentro de quê.
// Ruim ❌
function saudacao(){
console.log("Olá");
}
// Melhor ✅
function saudacao() {
console.log("Olá");
}
💡 Um código bem indentado é mais fácil de ler, entender e corrigir!
💬 Use comentários pra explicar seu código
Comentários não são lidos pelo computador, mas ajudam outros devs (ou o seu "eu do futuro") a entender o que está rolando. 😄
// Exibe uma mensagem de boas-vindas
console.log("Bem-vindo ao site!");
Use comentários com moderação — eles não devem substituir um código bem escrito!
❌ Evite usar var
(use let
e const
no lugar)
var
(use let
e const
no lugar)No passado, usávamos var
para criar variáveis. Hoje em dia, ela pode causar problemas de escopo (variáveis funcionando onde não deveriam).
Prefira:
let
: para variáveis que podem mudarconst
: para variáveis que não mudam
let idade = 18;
const nome = "Lara";
✂️ Divida códigos longos em funções menores
Evite escrever códigos gigantes tudo junto! Divida em funções pequenas, que tenham um objetivo claro.
// Ruim ❌
function processarTudoDeUmaVez() {
// muito código aqui 😩
}
// Melhor ✅
function validarDados() { ... }
function salvarNoBanco() { ... }
function mostrarMensagem() { ... }
🔍 Isso facilita a leitura, teste e manutenção do seu código!
🎨 Organização é tudo!
Use espaços entre os blocos pra separar partes do código.
Nomeie funções com verbos (ex:
mostrarAlerta
,calcularDesconto
).Evite repetir código — se algo se repete, transforme em uma função!
🧠 Resumão de boas práticas
🧩 camelCase
Deixa os nomes das variáveis mais legíveis
🟰 ===
ao invés de ==
Garante comparações seguras
📐 Indentação
Facilita leitura e manutenção
💬 Comentários
Explicam o que o código faz
❌ Não usar var
Evita bugs complicados de escopo
✂️ Funções pequenas
Código mais limpo e reutilizável
🎨 Organização geral
Seu código fica com cara de profissional!
Se você começar com boas práticas desde o início, vai crescer como dev com muito mais segurança e clareza. 🧑💻✨
Last updated