Clean Code — princípios que aplico no dia a dia

Código limpo não é sobre estética. É sobre reduzir o custo cognitivo de entender, modificar e estender um sistema ao longo do tempo.

Nomes importam mais do que você pensa

A regra mais subestimada: gaste tempo nomeando variáveis, funções e classes. Um bom nome elimina a necessidade de comentários. Compare:

// Ruim
const d = new Date();
const fn = (x: number) => x * 1.1;

// Bom
const dataDeCriacao = new Date();
const aplicarImposto = (valorBase: number) => valorBase * 1.1;

A diferença parece trivial, mas em uma base de código com milhares de linhas, nomes descritivos são a diferença entre entender algo em segundos e em minutos.

Funções pequenas, responsabilidade única

Toda função deve fazer exatamente uma coisa. Se você precisa usar “e” ao descrever o que uma função faz, ela provavelmente está fazendo coisa demais.

// Ruim: validar, transformar E salvar
function processarPedido(pedido: Pedido) {
	if (!pedido.itens.length) throw new Error('Pedido vazio');
	pedido.total = pedido.itens.reduce((s, i) => s + i.preco, 0);
	return database.salvar(pedido);
}

// Bom: separar responsabilidades
function validarPedido(p: Pedido) {
	/* ... */
}
function calcularTotal(p: Pedido) {
	/* ... */
}
function salvarPedido(p: Pedido) {
	/* ... */
}

O custo real da dívida técnica

Toda vez que você diz “depois eu arrumo”, está contratando uma dívida com juros compostos. O código ruim não fica parado esperando — ele se espalha. Novas features são construídas sobre ele, bugs se aninham nele, e a refatoração que levaria 2 horas hoje leva 2 semanas daqui a 6 meses.

Pragmatismo acima de dogmatismo

Clean Code não é uma religião. Há momentos em que duplicar código é melhor do que criar uma abstração prematura. Há momentos em que performance justifica código menos legível (com documentação adequada).

O equilíbrio está em entender o porquê de cada princípio e aplicar com julgamento, não com fé cega.