10 boas práticas de código limpo em Python
Código limpo em Python não é luxo, é necessidade. Neste guia, apresentamos 10 boas práticas essenciais — de nomes descritivos a testes automatizados — que transformam seu código em algo que outros desenvolvedores (e você no futuro) conseguem ler e modificar sem dor de cabeça.
Código limpo em Python não é sobre estética, é sobre comunicação. Quando você escreve código que qualquer colega de equipe entende de primeira, economiza horas de debugging e reunião. As 10 práticas a seguir ajudam a transformar scripts confusos em programas que contam uma história clara.
1. Use nomes que revelam a intenção
Nomes de variáveis, funções e classes devem dizer o que fazem sem exigir comentários. d não diz nada; data_frame já ajuda; sales_data_2024 é autoexplicativo. Em Python, siga a convenção snake_case para variáveis e funções, CamelCase para classes. Um nome bom corta a necessidade de ler o corpo da função.
2. Escreva funções pequenas e com uma única responsabilidade
Uma função deve fazer uma coisa e fazer bem. Se você precisa do "e" para descrevê-la, ela faz mais de uma. Exemplo: process_and_save(data) viola o princípio; prefira clean_data(data) e save_to_database(data). Funções pequenas são fáceis de testar, reutilizar e entender.
3. Evite comentários que explicam o óbvio
Comentários devem dizer o porquê, não o como. # Incrementa contador ao lado de counter += 1 é ruído. Use comentários para decisões de negócio, algoritmos não óbvios ou workarounds temporários. Se o código precisa de comentário para ser entendido, o nome ou a estrutura estão errados.
4. Aproveite as estruturas nativas do Python
List comprehensions, enumerate, zip, dict.get() e collections.defaultdict reduzem linhas e aumentam legibilidade. Comparação: um loop for i in range(len(lista)) contra for i, item in enumerate(lista). A segunda versão é mais limpa e evita erros de índice. Mas cuidado: comprehensions complexas demais viram ofuscação.
5. Trate exceções com precisão
Nunca use except: genérico, ele esconde erros inesperados e dificulta debugging. Capture exceções específicas (ValueError, KeyError, FileNotFoundError) e, quando possível, use else e finally para separar fluxo normal de tratamento de erro. Exemplo: try: valor = int(input()) except ValueError: print("Número inválido").
6. Evite magic numbers e strings soltas
Números e strings literais espalhados pelo código viram pesadelo de manutenção. Crie constantes no topo do módulo com nomes em maiúsculas: MAX_RETRIES = 3, DEFAULT_TIMEOUT = 30. Se o valor mudar, você altera em um lugar só e evita caçar ocorrências.
7. Prefira duck typing a herança complexa
Python é dinâmico; não force hierarquias de classes quando uma interface implícita resolve. Se um objeto tem o método .save(), você pode chamá-lo sem verificar o tipo. Herança profunda gera acoplamento e dificuldade de teste. Use mixin ou composição quando precisar compartilhar comportamento.
8. Mantenha arquivos e módulos enxutos
Um arquivo com 2000 linhas é difícil de navegar. Separe responsabilidades em módulos: modelo, visão, controlador? Depende do projeto. Mas uma boa regra é: se você perde a noção do que está no topo do arquivo, está na hora de dividir. Cada módulo deve ter um propósito claro.
9. Escreva testes desde o começo
Testes não são opcionais. Um código limpo é testável; se você não consegue testar uma função isoladamente, ela provavelmente faz demais ou tem acoplamento excessivo. Comece com unittest ou pytest e foque em testes pequenos e rápidos. Cobertura de 100% não é meta, mas testar os caminhos críticos sim.
10. Siga o Zen of Python e as PEPs
Digite import this no interpretador e leia os 19 aforismos. Eles resumem a filosofia da linguagem: simples é melhor que complexo, legível conta. A PEP 8 (estilo) e PEP 257 (docstrings) são referências práticas. Configure um linter como flake8 ou pylint para automatizar a verificação.
Perguntas frequentes sobre código limpo em Python
O que é código limpo?
Código limpo é aquele que qualquer desenvolvedor consegue ler e modificar sem esforço extra. Prioriza clareza, simplicidade e manutenibilidade, seguindo convenções e evitando complexidade desnecessária.
O que é Clean Code?
Clean Code é um livro de Robert C. Martin (2008) que define princípios de código limpo, focando em nomes, funções, comentários e testes. Embora os exemplos sejam em Java, os conceitos se aplicam a qualquer linguagem, incluindo Python.
Quais são as 40 palavras restritas do Python?
Python tem 35 palavras reservadas (versão 3.12), como False, None, True, and, as, assert, break, class, continue, def, del, elif, else, except, finally, for, from, global, if, import, in, is, lambda, nonlocal, not, or, pass, raise, return, try, while, with, yield. Elas não podem ser usadas como nomes de variáveis.
Como apagar tudo no Python?
Depende do contexto. No console interativo, %reset (IPython) ou reiniciar o kernel. Em um script, para limpar variáveis, use del var ou reatribua None. Para apagar conteúdo de um arquivo, abra no modo 'w'. Não há comando único que "apague tudo", Python gerencia memória automaticamente.