O código deve ter uma estrutura consistente. A "regra do acampamento" aplica-se aqui: .
O ideal é que uma função tenha zero, um ou no máximo dois argumentos. Três ou mais exigem uma justificativa muito forte. Comentários são "Falhas" CГіdigo limpo
Comentários legais, avisos sobre consequências técnicas ou explicações de algoritmos complexos de terceiros são aceitáveis. 3. Formatação e Estrutura O código deve ter uma estrutura consistente
Uma função deve fazer apenas uma coisa e fazê-la bem (). Se uma função tem mais de 20 linhas ou muitos níveis de aninhamento (como vários if dentro de for ), ela provavelmente deve ser dividida. Três ou mais exigem uma justificativa muito forte
Essencial para a legibilidade, mostrando a hierarquia e o fluxo lógico. 4. Tratamento de Erros
Não existe código limpo sem testes. Os testes garantem que a refatoração (o ato de limpar o código) não quebre funcionalidades existentes. Um bom teste segue o acrônimo : F ast (Rápido) I ndependent (Independente) R epeatable (Repetível) S elf-Validating (Auto-validável) T imely (Oportuno/No momento certo) Conclusão
Escrever código limpo não é apenas uma questão de estética; é uma estratégia para reduzir a dívida técnica, facilitar a manutenção e garantir que o software possa evoluir sem se tornar um pesadelo de bugs. 1. O que define um Código Limpo?