Localizar e corrigir erros básicos

Imagine este código salvo em um arquivo chamado relatorio.py. Ao executá-lo, o Python exibe uma mensagem que ajuda a localizar a falha.

• Arquivo: File "relatorio.py" indica qual arquivo examinar.
• Linha: line 2 indica a linha 2 do código, não da saída.
• Trecho: print(total) mostra a instrução apontada.
• Mensagem final: NameError é o nome do tipo de erro. Depois dos dois-pontos, name 'total' is not defined descreve o problema: o nome total não está definido.

Por enquanto, concentre-se em encontrar essas pistas; a correção desse tipo de erro virá adiante.

No exemplo, Início aparece porque a primeira instrução foi executada. A falha ocorre na segunda instrução e interrompe o script: Fim não é exibido.

Uma falha durante a execução não desfaz o que já aconteceu, mas impede que as instruções seguintes sejam alcançadas.

Leia a mensagem final → examine o trecho no arquivo e na linha indicados → faça um ajuste pontual → salve o arquivo → execute novamente e confira a saída.

Evite mudar várias coisas de uma vez: um ajuste por vez ajuda a verificar seu efeito.

Um SyntaxError indica que o Python não conseguiu interpretar a escrita como código válido. Em um script, esse erro é detectado antes de executar qualquer instrução — mesmo as que aparecem antes do problema.

Já uma falha durante a execução acontece quando o Python tenta realizar uma instrução com sintaxe válida.

No seu computador, salve este código como sintaxe.py e execute o arquivo. Leia a mensagem e procure o delimitador incompleto.

NameError indica que um nome não está definido naquele ponto do script. Comece comparando o nome citado na mensagem com o que recebeu um valor.

A mensagem diz que o nome Total não está definido. A atribuição criou total, com inicial minúscula: são nomes diferentes. Trocar print(Total) por print(total) corrige a divergência; ao salvar e executar novamente, a saída será 30.

Se a escrita está correta, verifique a ordem. Não basta ter uma atribuição em algum lugar do arquivo: ela precisa ser executada antes do uso.

Ao executar esse script, a linha 1 produz NameError: name 'preco' is not defined. Nesse momento, preco = 20 ainda não foi executada. A correção é mover essa atribuição para antes do cálculo, não mudar o nome.

Um TypeError pode indicar que uma operação não é suportada pelos tipos envolvidos. Neste script, a intenção é somar duas unidades à quantidade:

A mensagem diz que só é possível concatenar str com str, não com int. Em quantidade + 2, quantidade contém texto e 2 é inteiro; esse + não faz a soma pretendida.

Se houver dúvida sobre o valor, insira print(type(quantidade)) antes da linha que falha. A saída <class 'str'> confirma o tipo.

Se a intenção é exibir um rótulo junto de um número, não é preciso somá-los com +. Uma f-string permite montar a apresentação mantendo o valor numérico:

Uma conversão pode aceitar o tipo do argumento e ainda falhar por causa do conteúdo. Nesse caso, ocorre um ValueError. Veja uma tentativa de converter texto em inteiro:

A mensagem cita '3.5': esse texto não representa um inteiro no formato esperado por int. Se a medida deve preservar a parte decimal, use float("3.5"). Se o dado deve ser uma contagem inteira, revise a entrada e forneça uma contagem válida, como "3", quando esse for o valor correto.

TypeError: os tipos não são compatíveis com a operação. ValueError: o tipo é aceito, mas o valor não serve para aquela conversão.

No seu editor, salve este código como medida.py e execute. Digite 2,5 e observe a mensagem final. Depois, execute novamente e digite 2.5.

ZeroDivisionError indica uma divisão ou cálculo de resto com divisor zero. Isso pode acontecer com /, // e %. O divisor é o valor à direita do operador: 0 / 3 é válido; 3 / 0 não é.

A descrição “division by zero” significa “divisão por zero”. A falha aparece na linha 3, mas a origem do divisor está na atribuição pessoas = 0, na linha 2.

No seu computador, salve este código em divisao.py e execute com a entrada 0. Localize a divisão indicada e siga a variável pessoas até o input. Depois, execute novamente com 3, representando um teste de distribuição de 12 itens entre três pessoas. A saída esperada é 4.0.

Em Python, a indentação — o espaço antes de uma instrução — delimita blocos de código. Não é só decoração: instruções de um mesmo bloco precisam de recuo consistente.

Nos scripts sequenciais deste tutorial, as instruções estão no nível superior, fora de qualquer bloco interno. Por isso, devem começar na margem esquerda. Observe o recuo indevido antes de print:

IndentationError é um erro de sintaxe relacionado à indentação. A descrição unexpected indent significa “recuo inesperado”. Neste arquivo, a linha 2 começa com espaços onde não deveria. Como o problema é de sintaxe, nenhuma instrução do script é executada.

No seu computador, crie recuos.py com o código completo da primeira tela, mantendo inicialmente os quatro espaços antes de print(total).

1. Salve e execute para observar o erro.
2. Remova os espaços ou tabulações antes de print(total), deixando o p na margem esquerda.
3. Salve e execute novamente.

Confira a saída esperada:

No seu editor, salve o código abaixo como compra.py. Ele deve ler o valor de uma compra e o frete, somar os dois e mostrar o total, mas contém três defeitos: um de escrita, um de nome e um de tipo.

Execute o arquivo como está. A cada tentativa, anote o arquivo, a linha indicada e a mensagem final. Examine o trecho, faça apenas o ajuste necessário, salve e execute novamente. Quando as perguntas aparecerem, digite 40 para a compra e 5 para o frete.