Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

NameError — referencia a un nombre no definido

NameError significa que Python no pudo encontrar un nombre utilizado en los ámbitos disponibles. Comprueba la escritura, el orden de las asignaciones y las importaciones. Distingue NameError de AttributeError. UnboundLocalError es una subclase de NameError.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

try:
    ...
except NameError as exc:
    ...

NameError se produce durante la ejecución cuando Python no puede encontrar un nombre utilizado en los ámbitos disponibles. Se aplica a nombres no cualificados, como total. Si existe un objeto obj pero no tiene el atributo value, la referencia fallida obj.value normalmente produce AttributeError, no NameError.

Comprueba la escritura y si la asignación o el import que vincula el nombre se ejecutó antes de usarlo. Comprueba también que el nombre sea visible en el ámbito actual. Una asignación situada más adelante en el archivo no hace que su valor esté disponible para el código que se ejecuta antes.

UnboundLocalError es una subclase de NameError: se produce cuando se lee una variable local de una función o método antes de que se le haya vinculado un valor. Una asignación a un nombre en cualquier lugar del bloque de una función puede hacer que ese nombre se trate como local. Por tanto, except NameError también captura UnboundLocalError.

En el ejemplo, ttoal es una errata de total. El controlador muestra el tipo de excepción y su atributo name; después, el programa muestra el valor correcto. Capturar la excepción no vuelve a intentar la expresión fallida. En el código habitual, corrige la causa en lugar de ocultar el error con un manejo demasiado amplio de excepciones.

Ejemplos

total = 12
try:
    print(ttoal)
except NameError as exc:
    print(type(exc).__name__)
    print(exc.name)
print(total)

Resultado

NameError
ttoal
12

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.

Fuentes