Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

NameError — riferimento a un nome non definito

NameError significa che Python non è riuscito a trovare un nome usato negli ambiti disponibili. Controlla l’ortografia, l’ordine delle assegnazioni e gli import. Distingui NameError da AttributeError. UnboundLocalError è una sottoclasse di NameError.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

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

NameError si verifica durante l’esecuzione quando Python non riesce a trovare un nome usato negli ambiti disponibili. Riguarda i nomi non qualificati, come total. Se un oggetto obj esiste ma non ha l’attributo value, il riferimento non riuscito obj.value genera normalmente AttributeError, non NameError.

Controlla l’ortografia e verifica se l’assegnazione o l’import che associa il nome è stato eseguito prima del suo utilizzo. Controlla anche che il nome sia visibile nell’ambito corrente. Un’assegnazione collocata più avanti nel file non rende il suo valore disponibile al codice eseguito prima.

UnboundLocalError è una sottoclasse di NameError: si verifica quando una variabile locale in una funzione o in un metodo viene letta prima che le sia stato associato un valore. Un’assegnazione a un nome in qualsiasi punto del blocco di una funzione può far sì che quel nome venga trattato come locale. Di conseguenza, except NameError intercetta anche UnboundLocalError.

Nell’esempio, ttoal è un errore di battitura di total. Il gestore stampa il tipo di eccezione e il suo attributo name; poi il programma stampa il valore corretto. Intercettare l’eccezione non riprova l’espressione non riuscita. Nel codice ordinario, correggi la causa invece di nascondere il problema con una gestione troppo ampia delle eccezioni.

Esempi

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

Risultato

NameError
ttoal
12

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti