中級

KeyError の原因と直し方

辞書に存在しないキーへアクセスしたときに出るエラーです。大文字小文字の違いも別のキーとして扱われます。

エラーメッセージの読み方

Traceback (most recent call last):

main.py

ファイル名

2

行番号 — 実際にクラッシュした行

<module>

発生場所 — <module> ならトップレベル、関数名ならその関数の中

KeyError

例外クラス — 何が起きたか。ここを検索するのが最短です

'email'

詳細メッセージ — どの値が問題だったか

このエラーが出る典型パターン

 1  user = {"name": "Tom", "age": 20}
 2  print(user["email"])
                  ^

 1  scores = {"math": 90, "science": 85}
 2  print(scores["Math"   ])
                     ^

 1  config = {"debug": True}
 2  print(config["verbose"])
                     ^

 1  user = {"profile": {"city": "Tokyo"}}
 2  print(user["profile"]["country"])
                              ^

 1  prices = {"apple": 100, "banana": 50}
 2  total = prices["apple"] + prices["orange"]
                                         ^
 3  print(total)

よくある誤解

IndexErrorと混同されがちですが、こちらは辞書（キーによるアクセス）専用のエラーです。存在確認をしたい場合はin演算子か.get()を使います。

実務での勘所

存在しないかもしれないキーを扱う方法は複数あり、場面によって使い分けます。if key in d: の後にd[key]と読む書き方は分かりやすい一方、辞書を2回検索することになります。d.get(key, default)は1回の検索で済み、見つからない場合の既定値もその場で指定できます。さらに「無ければ新しく作ってから使う」場面が多いなら、collections.defaultdictを使えば、存在しないキーへのアクセス自体が自動的に既定値を作ってくれるため、KeyErrorの心配自体が要らなくなります。

演習をはじめる

関連するエラー

• Noneに対してメソッドを呼び出した原因と直し方Noneに対してメソッドを呼び出したときに出るエラーです。
• IndexError: list index out of range の原因と直し方リストの範囲外の添字にアクセスしたときに出るエラーです。