CKTIS / Python
NameError — odwołanie do niezdefiniowanej nazwy
NameError oznacza, że Python nie znalazł użytej nazwy w dostępnych zakresach. Sprawdź pisownię, kolejność przypisań i importy. Odróżniaj NameError od AttributeError. UnboundLocalError jest podklasą NameError.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
try:
...
except NameError as exc:
...NameError powstaje podczas wykonywania kodu, gdy Python nie może odnaleźć użytej nazwy w dostępnych zakresach. Dotyczy nazw niekwalifikowanych, takich jak total. Jeśli obiekt obj istnieje, ale nie ma atrybutu value, nieudane odwołanie obj.value zwykle powoduje AttributeError, a nie NameError.
Sprawdź pisownię oraz to, czy przypisanie lub import wiążący nazwę wykonały się przed jej użyciem. Upewnij się też, że nazwa jest widoczna w bieżącym zakresie. Samo przypisanie umieszczone później w pliku nie udostępnia wartości wcześniej wykonywanemu kodowi.
UnboundLocalError jest podklasą NameError: występuje przy odczycie lokalnej zmiennej w funkcji lub metodzie, zanim zostanie z nią związana wartość. Przypisanie do nazwy gdziekolwiek w bloku funkcji może sprawić, że będzie ona traktowana jako lokalna. Dlatego except NameError przechwytuje również UnboundLocalError.
W przykładzie ttoal to literówka w nazwie total. Obsługa wyjątku wypisuje jego typ i atrybut name, a potem program wypisuje poprawną wartość. Przechwycenie wyjątku nie ponawia nieudanego wyrażenia. W zwykłym kodzie popraw przyczynę zamiast ukrywać błąd szeroką obsługą wyjątków.
Przykłady
total = 12
try:
print(ttoal)
except NameError as exc:
print(type(exc).__name__)
print(exc.name)
print(total)Wynik
NameError ttoal 12
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.