Clean Code: A arte de não envergonhar o seu eu do futuro 😅

Espero que você goste desse conteúdo. Mais conteúdo sobre esse tema visite meu canal no YouTube, clique aqui Autor: James Moro

Publicado em: Low Code
26 visualizações

Você já abriu um código antigo seu e pensou:
“Meu Deus, quem escreveu essa bagunça?”
E logo em seguida percebeu que… foi você mesmo?

Se sim, bem-vindo ao clube.

Manter um código limpo não é só uma prática bonita para o GitHub ou um capricho de desenvolvedor perfeccionista. Escrever Clean Code é um ato de empatia. Com os colegas de equipe, com quem vai dar manutenção depois (geralmente você mesmo), e com a sanidade de todo mundo envolvido.

O que é “Clean Code”, afinal?

O termo “Clean Code” ficou famoso com o livro de mesmo nome, escrito por Robert C. Martin (o famoso Uncle Bob). Em resumo, trata-se de um conjunto de boas práticas para escrever código legível, organizado e de fácil manutenção.

Mas não se trata apenas de indentação bonita ou nomes de variáveis bonitinhos. É sobre intenção clara, responsabilidade única e simplicidade.

Por que se preocupar com isso?

Você vai voltar nesse código.
E provavelmente quando estiver com pressa ou num bug urgente.
Outras pessoas vão ler seu código.
E elas vão te julgar (até com carinho, mas vão).
Código ruim custa caro.
Tempo, dinheiro e paciência. Especialmente em equipes.

Dicas práticas pra deixar seu código menos vergonhoso

1. ✍️ Dê nomes decentes

Nada de data1, xpto ou objAux. Nomeie variáveis, funções e arquivos com clareza. O código deve explicar a si mesmo.

// Antes
function calc(d) {
  return d * 24 * 60;
}

// Depois
function convertDaysToMinutes(days) {
  return days * 24 * 60;
}

2. 🧱 Funções pequenas e objetivas

Uma função deve fazer uma única coisa — e bem.

// Errado
function handleEverything() {
  validate();
  saveToDatabase();
  sendEmail();
  showSuccessMessage();
}

// Certo
function handleSubmission() {
  if (!isValid()) return;

  saveToDatabase();
  notifyUser();
}

3. 🧼 Evite comentários desnecessários

Se você precisa explicar com comentários o que seu código faz, talvez ele não esteja claro o suficiente.

Comentário bom é aquele que explica o porquê, e não o como.

4. 🧩 Organize seus arquivos e pastas

Crie estruturas que façam sentido. Evite jogar tudo em uma pasta utils ou helpers.

5. 🔄 Revise com frequência

Refatorar não é desperdício de tempo. É como arrumar a casa: você vive melhor depois.

Clean Code é processo, não perfeição

Você não precisa ser um monge do código puro pra começar. Pequenas atitudes já fazem diferença. Comece a olhar seu código com carinho e pense:
“Será que meu eu daqui 6 meses vai me agradecer… ou me xingar?”

Spoiler: você ainda vai cometer deslizes. E tudo bem. O importante é ir melhorando com o tempo — e rindo dos erros antigos no caminho 😅

E aí, como anda o seu legado de código?

Se curtiu esse post, compartilha com aquele amigo que ainda chama função de doSomething() 😆
Ou deixa nos comentários o pior código que você já encontrou (ou escreveu)!