Aprender Python é empolgante. É uma das linguagens de programação mais populares do mundo e muito usada em áreas como desenvolvimento web, análise de dados, inteligência artificial e automação.
Mas, como em qualquer nova habilidade, é fácil cometer erros no começo. Esses erros não significam que você é “ruim em programação” — eles fazem parte do aprendizado.
Neste artigo, vamos ver os erros mais comuns que iniciantes em Python cometem e como você pode evitá-los, com exemplos práticos e dicas para melhorar seu código.
1. Não entender bem a indentação do código
O Python usa indentação (espaços no início da linha) para definir blocos de código. Em outras linguagens, isso é feito com chaves {}.
Se a indentação estiver errada, seu programa não vai rodar.
Exemplo de erro:
if True:
print("Olá!")Erro: O comando print não está indentado.
Como corrigir:
if True:
print("Olá!")Dica para evitar:
- Use sempre 4 espaços para cada nível de indentação (o Python aceita Tab, mas misturar Tab e espaço dá problema).
- Configure seu editor de texto para inserir espaços automaticamente.
2. Confundir atribuição (=) com comparação (==)
O sinal = serve para atribuir valores. O == serve para comparar valores.
Exemplo de erro:
x = 5
if x = 5: # Erro de sintaxe
print("Igual a 5")Como corrigir:
x = 5
if x == 5:
print("Igual a 5")Dica para evitar:
- Lembre: um sinal de igual significa “guardar valor”.
- Dois sinais de igual significam “comparar”.
3. Esquecer os dois pontos (:) em estruturas de controle
Em Python, if, for, while, def e outros blocos precisam terminar com dois pontos.
Exemplo de erro:
if x == 5
print("Cinco")Como corrigir:
if x == 5:
print("Cinco")Dica para evitar:
- Sempre que abrir um bloco, finalize a linha com
:.
4. Não usar corretamente os nomes de variáveis
Muitos iniciantes colocam nomes vagos ou confusos nas variáveis. Isso dificulta a leitura e manutenção do código.
Exemplo ruim:
a = 10
b = 20
c = a + bExemplo bom:
preco_produto = 10
quantidade = 20
total = preco_produto + quantidade
Dica para evitar:
- Use nomes claros e descritivos.
- Não comece variáveis com números.
- Evite usar palavras reservadas do Python (como
list,for,if).
5. Esquecer de converter tipos de dados
Python não soma números e textos sem conversão.
Exemplo de erro:
idade = 25
print("Eu tenho " + idade + " anos") # ErroComo corrigir:
idade = 25
print("Eu tenho " + str(idade) + " anos")Ou:
print(f"Eu tenho {idade} anos")Dica para evitar:
- Use
str()para converter para texto. - Use f-strings para juntar texto e variáveis de forma simples.
6. Não entender a diferença entre lista e cópia de lista
Quando você copia uma lista assim:
lista_a = [1, 2, 3]
lista_b = lista_aAs duas variáveis apontam para a mesma lista. Alterar uma altera a outra.
Exemplo de problema:
lista_b.append(4)
print(lista_a) # [1, 2, 3, 4]Como corrigir:
lista_b = lista_a.copy()Ou:
lista_b = lista_a[:]Dica para evitar:
- Sempre que quiser uma cópia independente, use
.copy().
7. Usar print para tudo
O print é ótimo para testes rápidos, mas confiar nele para depurar (achar erros) é limitado.
Problema: Você enche o código de print() e esquece de remover depois.
Melhor abordagem:
- Use
print()apenas para mensagens importantes. - Aprenda a usar a ferramenta de debug do seu editor.
- Adicione logs com a biblioteca
loggingquando precisar monitorar.
8. Não tratar erros com try e except
Se o código encontra um erro, ele para imediatamente. Isso pode ser ruim.
Exemplo de erro:
numero = int(input("Digite um número: "))
print(10 / numero) # Se o usuário digitar 0, o programa quebraComo corrigir:
try:
numero = int(input("Digite um número: "))
print(10 / numero)
except ZeroDivisionError:
print("Você não pode dividir por zero.")
except ValueError:
print("Digite apenas números.")Dica para evitar:
- Sempre que o código depender da entrada do usuário, use
try/except.
9. Esquecer de fechar arquivos
Quando abrir arquivos, feche-os para evitar problemas.
Exemplo de erro:
arquivo = open("dados.txt", "r")
conteudo = arquivo.read()
# arquivo.close() foi esquecidoComo corrigir:
with open("dados.txt", "r") as arquivo:
conteudo = arquivo.read()Vantagem: O with fecha o arquivo automaticamente.
10. Não entender o escopo das variáveis
O escopo define onde a variável existe no código.
Exemplo de erro:
def minha_funcao():
x = 10
print(x) # Erro: x não existe fora da funçãoComo evitar:
- Use variáveis dentro do menor escopo possível.
- Só use variáveis globais quando realmente necessário.
11. Usar laços for ou while sem controle
Um loop infinito pode travar seu programa.
Exemplo:
while True:
print("Rodando...")Como corrigir:
- Sempre inclua uma condição de parada.
- Teste com dados pequenos antes de rodar com dados grandes.
12. Não aproveitar bibliotecas prontas
Muitos iniciantes tentam criar tudo do zero. Isso é bom para aprender, mas ruim para produtividade.
Exemplo: Criar um sistema para manipular datas manualmente em vez de usar o datetime.
Dica:
- Pesquise primeiro: “Python biblioteca para [problema]”.
- Use bibliotecas como
math,os,jsonerequests.
13. Usar números “mágicos” no código
Um número mágico é um valor colocado direto no código, sem explicação.
Exemplo:
salario = 5000
aumento = salario * 0.07Melhor forma:
TAXA_AUMENTO = 0.07
salario = 5000
aumento = salario * TAXA_AUMENTO14. Ignorar mensagens de erro
Muitos iniciantes ficam com medo de erros e apenas tentam “chutar” soluções.
Dica:
- Leia a mensagem de erro com atenção.
- Procure as palavras-chave no Google.
- Muitas vezes, a mensagem já indica o problema.
15. Não comentar o código
Comentários ajudam você e outras pessoas a entenderem o que o código faz.
Exemplo:
# Calcula o preço final com desconto
preco_final = preco * 0.9Dica:
- Comente o porquê do código, não apenas o que ele faz.
- Não exagere nos comentários desnecessários.
16. Não praticar o suficiente
O maior erro é não escrever código. Ler sobre Python ajuda, mas só praticando você realmente aprende.
Sugestão:
- Resolva desafios de programação.
- Crie pequenos projetos, como calculadoras ou jogos simples.
- Participe de fóruns como o Stack Overflow.
Tabela Resumo dos Erros Comuns
| Erro Comum | Exemplo | Como Evitar |
|---|---|---|
| Indentação errada | if True: print("Oi") | Use 4 espaços |
Confundir = e == | if x = 5 | Use == para comparar |
Esquecer : | if x == 5 | Sempre finalize blocos com : |
| Nomes ruins | a = 10 | Use nomes descritivos |
| Tipo errado | "Idade " + 25 | Converta com str() |
| Lista ligada | lista_b = lista_a | Use .copy() |
print para tudo | Muitos print() | Use debug e logging |
| Sem tratamento de erro | 10 / 0 | Use try/except |
| Arquivo não fechado | open(...) sem fechar | Use with open(...) |
| Escopo errado | print(x) fora da função | Use variáveis locais |
| Loop infinito | while True | Adicione condição de saída |
| Ignorar bibliotecas | Criar do zero | Pesquise soluções prontas |
| Números mágicos | x = 0.07 | Use constantes nomeadas |
| Ignorar erros | Apagar código | Ler e pesquisar mensagens |
| Sem comentários | Código confuso | Explique com comentários |
| Não praticar | Só ler tutoriais | Fazer exercícios |
Conclusão
Cometer erros no início é normal. O importante é identificar, entender e corrigir.
Os erros comuns que iniciantes em Python cometem — como problemas de indentação, confusão entre = e ==, ou esquecer de tratar erros — podem ser evitados com atenção, prática e boas práticas de programação.
Lembre-se: programar é resolver problemas. Quanto mais você pratica, menos erros comete e mais rápido encontra soluções.
Se você está começando, use este guia como referência. Volte sempre que encontrar um erro e veja se ele está nesta lista.
Assim, sua jornada no Python será mais tranquila e produtiva.
