Page cover

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 ==

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)

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 mudar

  • const: 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

Prática
Por quê seguir?

🧩 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