Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła