Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

NameError — referência a um nome não definido

NameError significa que o Python não conseguiu encontrar um nome utilizado nos âmbitos disponíveis. Verifique a ortografia, a ordem das atribuições e as importações. Distinga NameError de AttributeError. UnboundLocalError é uma subclasse de NameError.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

try:
    ...
except NameError as exc:
    ...

NameError ocorre durante a execução quando o Python não consegue encontrar um nome utilizado nos âmbitos disponíveis. Aplica-se a nomes não qualificados, como total. Se um objeto obj existir mas não tiver o atributo value, a referência falhada obj.value normalmente gera AttributeError, não NameError.

Verifique a ortografia e se a atribuição ou o import que associa o nome foi executado antes da sua utilização. Verifique também se o nome está visível no âmbito atual. Uma atribuição colocada mais adiante no ficheiro não disponibiliza o seu valor ao código executado anteriormente.

UnboundLocalError é uma subclasse de NameError: ocorre quando uma variável local numa função ou método é lida antes de lhe ter sido associado um valor. Uma atribuição a um nome em qualquer ponto do bloco de uma função pode fazer com que esse nome seja tratado como local. Por isso, except NameError também captura UnboundLocalError.

No exemplo, ttoal é um erro de escrita de total. O processador da exceção apresenta o tipo da exceção e o respetivo atributo name; em seguida, o programa apresenta o valor correto. Capturar a exceção não volta a tentar a expressão que falhou. No código habitual, corrija a causa em vez de ocultar o erro com um tratamento de exceções demasiado abrangente.

Exemplos

total = 12
try:
    print(ttoal)
except NameError as exc:
    print(type(exc).__name__)
    print(exc.name)
print(total)

Resultado

NameError
ttoal
12

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes