CKTIS / Python
KeyError — clave inexistente en un mapping
KeyError significa que no se encontró una clave solicitada en un mapping, como un dict. Aprende la diferencia entre acceder con corchetes y usar get(), y gestiona las claves que faltan sin ocultar errores que no están relacionados.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
try:
value = mapping[key]
except KeyError:
...KeyError es una excepción incorporada que deriva de LookupError. Indica que falta una clave solicitada en un mapping. En un dict normal, mapping[key] lanza esta excepción cuando la clave no existe. No la confundas con IndexError, que se refiere a un índice fuera de rango en una secuencia.
Si es previsible que falte una clave, usa try / except KeyError o mapping.get(key, default). En un dict, get() devuelve el valor predeterminado solo cuando la clave no está; si no se indica explícitamente un valor predeterminado, en ese caso devuelve None. Una clave existente cuyo valor es None no se considera ausente y no hace que se use el valor predeterminado. La expresión key in mapping comprueba si la clave está presente.
Limita el bloque try a la operación cuya clave ausente quieres gestionar, para no capturar accidentalmente un KeyError de otra llamada. Si la clave es obligatoria, corrige los datos de entrada o deja que la excepción se propague en lugar de ignorarla sin más.
El ejemplo contrasta la clave "language", que falta, con la clave existente "nickname", cuyo valor es None. Ten en cuenta que una subclase de dict puede definir __missing__() para cambiar cómo gestiona mapping[key] una clave ausente; get() no invoca ese mecanismo.
Ejemplos
settings = {"theme": "dark", "nickname": None}
try:
print(settings["language"])
except KeyError:
print("Missing key: language")
print(settings.get("language", "en"))
print(settings.get("nickname", "guest"))Resultado
Missing key: language en None
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.