Erros de sintaxe sem pânico: lendo o que o Python diz

Os três tropeços clássicos da primeira semana

No módulo 1 você quebrou um código de propósito e sobreviveu. Agora vamos organizar esse conhecimento, porque três erros específicos respondem pela maioria dos sustos da primeira semana, e conhecê-los pelo nome tira o mistério. Todos os exemplos abaixo estão errados de propósito; digite cada um no Playground e veja a reclamação de perto.

print("Bem-vindos ao curso!)

# ERRADO de propósito: a aspa dupla abriu e nunca fechou.
# SyntaxError: unterminated string literal (detected at line 1)

Tropeço 1: aspa sem fechar. O Python avisa que a string ficou aberta.

print("Bem-vindos ao curso!"

# ERRADO de propósito: o parêntese abriu e nunca fechou.
# SyntaxError: '(' was never closed

Tropeço 2: parêntese esquecido. A mensagem diz qual símbolo ficou sem par.

Print("Bem-vindos ao curso!")

# ERRADO de propósito: print se escreve com p minúsculo.
# NameError: name 'Print' is not defined. Did you mean: 'print'?

Tropeço 3: maiúscula indevida. Repare que aqui o tipo muda: é NameError, não SyntaxError.

O terceiro caso merece um comentário. Print com maiúscula não é erro de escrita: a frase está gramaticalmente válida, então o interpretador começa a executar. O problema estoura na hora de procurar o nome Print, que não existe, porque o Python diferencia maiúsculas de minúsculas. Por isso o tipo é NameError, nome não definido. E olhe a gentileza do Python moderno: ele ainda sugere, você quis dizer print?

Anatomia da mensagem: linha, seta e tipo

Mensagem de erro parece um bloco assustador de texto em inglês, mas tem estrutura fixa, e você só precisa de três informações dela. Veja uma mensagem real, gerada por um arquivo com aspa sem fechar na linha 2, e o mapa das partes.

  File "cartao.py", line 2
    print("Sou estudante de Python
          ^
SyntaxError: unterminated string literal (detected at line 2)

Uma mensagem de erro completa do Python 3.12. Três pistas: o arquivo e a linha, a seta e o tipo.

Uma honestidade importante: a seta acerta o ponto exato na maioria das vezes, mas não sempre. Um parêntese esquecido, por exemplo, só é sentido pelo Python linhas depois, quando ele percebe que a conta não fecha. Se a linha apontada parecer inocente, olhe também a linha de cima. Esse pequeno ceticismo economiza muitos minutos de encarar a linha errada.

O ciclo ler-corrigir-rodar

Conhecidos os erros e a mensagem, falta o método. Diante de qualquer erro, o caminho é um ciclo de três passos: ler a mensagem procurando linha, seta e tipo; corrigir apenas o que a mensagem aponta; rodar de novo. Se aparecer outro erro, sem drama: repete o ciclo. Programas reais às vezes escondem dois ou três tropeços em fila, e cada rodada revela o próximo.

1. LER: encontre o número da linha, a seta e o tipo do erro na mensagem.
2. CORRIGIR: mexa só na linha apontada (ou na de cima, se ela parecer inocente). Nada de reescrever o programa inteiro.
3. RODAR: execute de novo. Funcionou? Siga em frente. Novo erro? Volte ao passo 1.

O inimigo desse ciclo é o impulso de apagar tudo e recomeçar do zero, que parece produtivo e não é: joga fora o que estava certo junto com o que estava errado, e não ensina nada. Corrigir cirurgicamente, guiado pela mensagem, é mais rápido e treina exatamente a leitura de erro que separa quem progride de quem trava. O módulo 14 aprofunda esse tema com os erros de execução; a base é a que você acabou de montar.

Feche a aula com um exercício de dessensibilização: no Playground, provoque os três tropeços clássicos, um por vez, e corrija cada um usando o ciclo. Aspa sem fechar, parêntese sem par, Print maiúsculo. Ao final, você terá visto e consertado, em ambiente seguro, os erros que respondem pela maior parte da frustração dos iniciantes. Susto visto de perto encolhe.