Pythonの辞書からキーを削除する方法を解説！del文・pop()・popitem()の使い分け

はじめに

Pythonの辞書（dict）は、キーと値のペアでデータを管理できる非常に便利なデータ構造です。プログラムの実行中に不要になった要素を削除したい場面は多くありますが、Pythonにはいくつかの削除方法が用意されています。

この記事では、代表的な削除方法であるdel文とpop()メソッドを中心に、それぞれの特徴や使い分けのポイントを実行例とともにわかりやすく解説します。

del文でキーを削除する

Pythonのdelキーワードは、ほぼすべてのオブジェクトに対して使用できます。辞書から特定の要素を削除する場合は、delステートメントにキーを指定します。

>>> D1 = {1: 'a', 2: 'b', 3: 'c', 'x': 1, 'y': 2, 'z': 3}
>>> del D1['x']
>>> D1
{1: 'a', 2: 'b', 3: 'c', 'y': 2, 'z': 3}

delはキー'x'とそれに対応する値1をまとめて削除し、元の辞書そのものを直接変更（破壊的操作）します。戻り値はないため、単純に「消すだけ」の場合に適しています。

pop()メソッドでキーを削除する

キーと値のペアを削除しつつ、削除した値を受け取りたい場合はpop()メソッドを使います。引数にはキーを指定し、同じキーに複数の値が割り当てられている場合なども柔軟に対応できます。

>>> D1 = {1: 'a', 2: 'b', 3: 'c', 'x': 1, 'y': 2, 'z': 3}
>>> D1.pop('y')
2
>>> D1
{1: 'a', 2: 'b', 3: 'c', 'x': 1, 'z': 3}

この例では、pop('y')が削除した値2を返していることが確認できます。削除と同時に値を利用したいケースで特に便利です。

存在しないキーへの対策

delもpop()も、指定したキーが辞書に存在しない場合、KeyErrorが発生します。pop()には第2引数としてデフォルト値を渡せるため、エラーを回避できます。

>>> D1.pop('not_exist', None)
# キーがなくてもNoneが返り、エラーにならない

その他の削除方法

• popitem()：挿入された順に最後のキーと値のペアを削除し、タプルとして返します（Python 3.7以降）。
• clear()：辞書内のすべての要素を一括で削除し、空の辞書にします。
• 辞書内包表記：特定条件に合う複数のキーを除外した新しい辞書を生成できます（元の辞書は保持されます）。

>>> D1 = {1: 'a', 2: 'b', 3: 'c'}
>>> D1.popitem()
(3, 'c')
>>> {k: v for k, v in D1.items() if k != 1}
{2: 'b'}

まとめ

用途に応じてこれらの方法を使い分けることで、より安全で読みやすいコードを書くことができます。特に、キーの存在が保証されない場合はpop()のデフォルト値を活用すると、KeyErrorによる予期しないエラーを防げます。