CKTIS / Python
NameError — Verweis auf einen nicht definierten Namen
NameError bedeutet, dass Python einen verwendeten Namen in den verfügbaren Gültigkeitsbereichen nicht finden konnte. Prüfe Schreibweise, Reihenfolge der Zuweisungen und Importe. Unterscheide NameError von AttributeError. UnboundLocalError ist eine Unterklasse von NameError.
Version: Python 3.14; repository image, production runtime not attested
Syntax
try:
...
except NameError as exc:
...NameError tritt während der Ausführung auf, wenn Python einen verwendeten Namen in den verfügbaren Gültigkeitsbereichen nicht finden kann. Er betrifft unqualifizierte Namen wie total. Wenn ein Objekt obj existiert, aber kein Attribut value hat, löst der fehlgeschlagene Verweis obj.value normalerweise AttributeError aus, nicht NameError.
Prüfe die Schreibweise und ob die Zuweisung oder der import, durch den der Name gebunden wird, vor seiner Verwendung ausgeführt wurde. Prüfe auch, ob der Name im aktuellen Gültigkeitsbereich sichtbar ist. Eine Zuweisung, die erst später in der Datei steht, macht ihren Wert für früher ausgeführten Code nicht verfügbar.
UnboundLocalError ist eine Unterklasse von NameError: Er tritt auf, wenn eine lokale Variable in einer Funktion oder Methode gelesen wird, bevor ihr ein Wert zugewiesen wurde. Eine Zuweisung an einen Namen an beliebiger Stelle im Funktionsblock kann dazu führen, dass dieser Name als lokal behandelt wird. Daher fängt except NameError auch UnboundLocalError ab.
Im Beispiel ist ttoal ein Schreibfehler für total. Der Ausnahme-Handler gibt den Ausnahmetyp und sein Attribut name aus; anschließend gibt das Programm den korrekten Wert aus. Das Abfangen der Ausnahme wiederholt den fehlgeschlagenen Ausdruck nicht. Behebe im normalen Code die Ursache, statt den Fehler durch eine breit gefasste Ausnahmebehandlung zu verbergen.
Beispiele
total = 12
try:
print(ttoal)
except NameError as exc:
print(type(exc).__name__)
print(exc.name)
print(total)Ergebnis
NameError ttoal 12
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.