CKTIS / Python
UnboundLocalError: lectura de una variable local no vinculada
UnboundLocalError se produce cuando una función lee una variable local que en ese momento no tiene ningún valor asignado. Es una subclase de NameError; una causa frecuente es una asignación que oculta una variable de un ámbito exterior.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
UnboundLocalErrorUnboundLocalError significa que se intenta leer una variable local de una función que no tiene un valor asociado en ese momento. Es una subclase de NameError: si no se encuentra un nombre, se produce NameError, mientras que este caso concreto de una variable local no vinculada produce UnboundLocalError.
Asignar un nombre dentro de una función hace que sea local en todo el cuerpo de esa función, salvo que se aplique una declaración global o nonlocal. Esto también ocurre con una asignación en una rama que nunca se ejecuta. En el ejemplo, count += 1 primero debe leer la variable local count; no usa el count = 10 del módulo. La excepción interrumpe la llamada y el valor del módulo sigue siendo 10.
Corrige la causa: asegúrate de asignar un valor antes de cada lectura posible, o pasa el valor como argumento y devuelve el resultado. Si quieres volver a vincular un nombre del módulo, usa global; para una vinculación existente en la función envolvente más cercana, usa nonlocal. Coloca la declaración antes de usar el nombre. Capturar la excepción en el ejemplo sirve para mostrar el problema, no para corregir el error de ámbito.
Ejemplos
count = 10
def increment():
count += 1
return count
try:
increment()
except UnboundLocalError as error:
print(type(error).__name__)
print(count)
Resultado
UnboundLocalError 10
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.