CKTIS / Python
UnboundLocalError – Lesen einer ungebundenen lokalen Variablen
UnboundLocalError tritt auf, wenn eine Funktion eine lokale Variable liest, der zu diesem Zeitpunkt kein Wert zugewiesen ist. Der Fehler ist eine Unterklasse von NameError; eine häufige Ursache ist eine Zuweisung, die eine Variable aus einem äußeren Gültigkeitsbereich überschattet.
Version: Python 3.14; repository image, production runtime not attested
Syntax
UnboundLocalErrorUnboundLocalError bezeichnet den Versuch, eine lokale Variable einer Funktion zu lesen, der zu diesem Zeitpunkt kein Wert zugewiesen ist. Der Fehler ist eine Unterklasse von NameError: Wird ein Name nicht gefunden, entsteht ein NameError; im speziellen Fall einer ungebundenen lokalen Variable entsteht UnboundLocalError.
Eine Zuweisung an einen Namen innerhalb einer Funktion macht diesen im gesamten Funktionskörper lokal, sofern keine Deklaration mit global oder nonlocal gilt. Das gilt auch für eine Zuweisung in einem Zweig, der nie ausgeführt wird. Im Beispiel muss count += 1 zuerst den lokalen Wert von count lesen; der modulweite Wert count = 10 wird nicht verwendet. Der Fehler unterbricht den Aufruf, und der modulweite Wert bleibt 10.
Beheben Sie die Ursache: Stellen Sie sicher, dass vor jedem möglichen Lesen ein Wert zugewiesen wird, oder übergeben Sie den Wert als Argument und geben Sie das Ergebnis zurück. Wenn Sie einen Namen auf Modulebene neu binden möchten, verwenden Sie global; für eine bestehende Bindung in der nächstgelegenen umschließenden Funktion verwenden Sie nonlocal. Setzen Sie die Deklaration vor die Verwendung des Namens. Das Abfangen des Fehlers im Beispiel dient der Veranschaulichung und behebt den Gültigkeitsbereichsfehler nicht.
Beispiele
count = 10
def increment():
count += 1
return count
try:
increment()
except UnboundLocalError as error:
print(type(error).__name__)
print(count)
Ergebnis
UnboundLocalError 10
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.