timeit executa um trecho muitas vezes e reduz interferências comuns, como a coleta de lixo durante a medição. Ele é adequado para perguntas pequenas, não para representar sozinho o desempenho de uma aplicação inteira.
Exemplo prático
from timeit import repeat
samples = [str(number) for number in range(100)]
times = repeat(
"','.join(samples)",
globals={"samples": samples},
number=10_000,
repeat=5,
)
print(f"best: {min(times):.4f}s")Monte um teste justo
O setup deve preparar dados sem entrar no tempo medido. Compare alternativas com a mesma entrada, o mesmo número de execuções e um ambiente pouco carregado. O menor valor entre repetições mostra o melhor cenário observado, não uma promessa de produção.
Use a linha de comando
python -m timeit "sum(range(100))" é suficiente para uma verificação rápida. Informe o comando, a versão do Python e a máquina ao publicar resultados.
Evite otimização prematura
Uma diferença minúscula em uma operação rara não justifica código mais obscuro. Primeiro localize o gargalo no fluxo real; depois use microbenchmarks para responder a uma hipótese específica.
Continue estudando
Aprofunde a base com guia de Python para iniciantes. A documentação oficial do Python, consultada em 22 de julho de 2026, detalha a API, as limitações e as diferenças entre versões.