WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen