programandoai

Comentários, erros de sintaxe e o hábito de ler a mensagem

Errar é parte do processo, mesmo para quem programa há anos. O que separa quem trava de quem avança é o hábito de realmente ler o que o Python está tentando te dizer.

Estudar esta lição interativa →

Todo mundo que programa, do primeiro dia até depois de anos de experiência, escreve código que não roda de primeira. Isso é tão normal que nem deveria ser chamado de fracasso, é só uma etapa do processo. O que faz diferença de verdade é o próximo passo: ler a mensagem de erro em vez de só encarar a tela travada. O Python é, entre as linguagens populares, uma das mais generosas nesse sentido: as mensagens de erro costumam apontar exatamente onde e por que algo deu errado.

print("Olá, mundo!"
print("Esta linha nunca roda.")

Rode e leia a mensagem no console com atenção.

Repare que o console mostrou algo como SyntaxError: '(' was never closed. Sintaxe é o conjunto de regras de escrita da linguagem, tipo a gramática de um idioma. Um SyntaxError significa que o Python nem chegou a tentar rodar o programa: ele leu o texto, percebeu que a estrutura está quebrada (aqui, um parêntese que abriu e nunca fechou) e parou ali, antes de qualquer linha ser executada.

Pense num SyntaxError como uma frase com a pontuação toda embaralhada: "Compre. Leite, pão manteiga e" não tem como ser entendida, porque a estrutura da frase quebrou antes mesmo do significado importar. Um erro de sintaxe em código é a mesma ideia: o problema é a forma, não ainda o conteúdo.

Isso é diferente de um erro que só aparece durante a execução, quando a estrutura do código está correta, mas alguma coisa dá errado ao rodar de verdade (usar um nome que não existe, por exemplo). Você vai ver bastante esse segundo tipo ao longo do curso; por enquanto, fixe a diferença: SyntaxError trava tudo antes de começar, os outros erros aparecem no meio do caminho, às vezes só numa linha específica.

print("Antes do erro, esta linha roda normalmente.")
print(variavel_que_nao_existe)
print("Esta linha nunca é alcançada.")

Este roda até a linha do erro, diferente do SyntaxError anterior.

Comentários: anotações que o Python ignora

Qualquer linha (ou parte de linha) que comece com # é um comentário: o Python simplesmente ignora tudo dali até o fim daquela linha. Comentários servem para explicar por que o código faz algo, para você mesmo no futuro ou para quem for ler depois. # calcula o total com desconto de 10% é bem mais útil do que nenhuma explicação.

Um clássico de quem vem de outra linguagem (ou de tutoriais antigos)

Se você já viu algum exemplo de Python bem antigo (de antes de 2020), pode ter visto print "algo", sem parênteses. Isso era válido no Python 2, hoje aposentado. No Python 3 (o único usado neste curso, e o padrão da indústria hoje), print é sempre uma função, e uma função sempre precisa de parênteses: print("algo"). Escrever print "algo" aqui gera SyntaxError: Missing parentheses in call to 'print', uma mensagem que, felizmente, já avisa exatamente qual é o problema.

# A linha de baixo devia rodar, mas está comentada por engano.
# print("Primeira linha, funcionando.")
print("Segunda linha."
print("Terceira linha.")

Corrija os dois problemas até rodar sem erro.

A variável mensagem deveria guardar o texto exato Bem-vindo ao Python!, mas a string está com um erro de sintaxe (a aspa de abertura não tem um par). Corrija a string para que mensagem passe a valer exatamente esse texto.
mensagem = "Bem-vindo ao Python!

🧩 Este é um exercício com correção automática — abra no app para completá-lo e verificar.

← Voltar ao índice do curso