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.