CKTIS / Python
KeyError — brak klucza w mapowaniu
KeyError oznacza, że żądanego klucza nie znaleziono w mapowaniu, na przykład słowniku dict. Poznaj różnicę między odczytem przez nawiasy kwadratowe a metodą get() i obsługuj brak klucza bez ukrywania innych błędów.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
try:
value = mapping[key]
except KeyError:
...KeyError jest wbudowanym wyjątkiem dziedziczącym po LookupError. Sygnalizuje brak żądanego klucza w mapowaniu. Dla zwykłego słownika dict wyrażenie mapping[key] zgłasza ten wyjątek, gdy klucz nie istnieje. Nie należy mylić go z IndexError, który dotyczy indeksu poza zakresem sekwencji.
Jeśli brak klucza jest przewidywaną sytuacją, użyj try / except KeyError albo mapping.get(key, default). W słowniku dict metoda get() zwraca wartość domyślną tylko wtedy, gdy klucza brakuje; bez podanej wartości domyślnej zwraca wtedy None. Istniejący klucz z wartością None nie oznacza braku klucza i nie powoduje użycia wartości domyślnej. Wyrażenie key in mapping sprawdza obecność klucza.
Ogranicz blok try do operacji, dla której chcesz obsłużyć brak klucza, aby nie przechwycić przypadkiem KeyError z innego wywołania. Jeśli klucz jest wymagany, napraw dane wejściowe lub pozwól wyjątkowi się propagować zamiast bezwarunkowo go ignorować.
Przykład pokazuje brak "language" oraz istniejący "nickname" z wartością None. Uwaga: podklasa dict może zdefiniować __missing__(), zmieniając zachowanie mapping[key] dla brakującego klucza; metoda get() nie wywołuje tego mechanizmu.
Przykłady
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"))Wynik
Missing key: language en None
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.