Clean Code: 7 Princípios que Todo Desenvolvedor Deve Conhecer

<h2>Por Que Clean Code Importa?</h2>
<p>Código é lido muito mais vezes do que escrito. Um código limpo economiza horas de debug, facilita manutenção e torna o trabalho em equipe mais eficiente.</p>

<h3>1. Nomes Significativos</h3>
<pre><code># Ruim
d = 86400

# Bom
SECONDS_PER_DAY = 86400

# Ruim
def calc(a, b):
return a * b * 0.1

# Bom
def calculate_discount(price, quantity):
DISCOUNT_RATE = 0.1
return price * quantity * DISCOUNT_RATE</code></pre>

<h3>2. Funções Pequenas</h3>
<p>Uma função deve fazer apenas UMA coisa. Se você usa "e" para descrever o que ela faz, divida-a.</p>
<pre><code># Ruim: faz duas coisas
def validate_and_save_user(user):
...

# Bom: responsabilidade única
def validate_user(user):
...

def save_user(user):
...</code></pre>

<h3>3. Evite Comentários Óbvios</h3>
<pre><code># Ruim
i = i + 1 # incrementa i

# Bom - código auto-explicativo
user_count += 1</code></pre>

<h3>4. DRY - Don't Repeat Yourself</h3>
<p>Se você copia e cola código, provavelmente precisa de uma função ou classe.</p>

<h3>5. Tratamento de Erros</h3>
<pre><code># Ruim
def get_user(id):
user = db.find(id)
if user:
return user
return None

# Bom
def get_user(id):
user = db.find(id)
if not user:
raise UserNotFoundError(f"User {id} not found")
return user</code></pre>

<h3>6. Formatação Consistente</h3>
<p>Use ferramentas como Black (Python), Prettier (JS) ou formatadores da sua linguagem. Não discuta estilo - automatize.</p>

<h3>7. Testes</h3>
<p>Código sem testes é código legado. Escreva testes antes ou junto com seu código (TDD).</p>

<h3>Recursos para Aprofundar</h3>
<ul>
<li>Livro: "Clean Code" - Robert C. Martin</li>
<li>Livro: "The Pragmatic Programmer"</li>
<li>Curso: Refactoring Guru</li>
</ul>

<h3>Conclusão</h3>
<p>Clean Code é uma jornada, não um destino. Pratique esses princípios diariamente e seu código (e carreira) agradecerão.</p>