Pythonで辞書に要素を追加する方法：updateや代入の使い分けを解説

Pythonのプログラムを開発する際、データの管理に辞書（dict型）を利用する機会は非常に多いでしょう。

辞書はキーと値のペアを保持するデータ構造であり、効率的なデータの検索や更新が可能です。

既存の辞書に対して新しい要素を追加する方法には、いくつかのバリエーションが存在します。

単純な代入から、複数の要素を一度に統合する方法、さらにはモダンな演算子を用いた手法まで多岐にわたります。

それぞれの方法には、コードの可読性や処理速度、実行時の挙動といった側面で異なる特徴があります。

この記事では、Pythonで辞書に要素を追加する主要な方法を整理し、シチュエーションに応じた最適な使い分けについて解説します。

基本的なキー指定による要素の追加

Pythonの辞書に要素を追加する最もシンプルで直感的な方法は、「キーを指定した代入」です。

この手法は、特定のキーに対して一つの値を紐付けたい場合に最適です。

構文は非常に単純で、辞書名[キー] = 値 という形式で記述します。

# 空の辞書を作成します
user_info = {}

# キー "name" に値 "Alice" を追加します
user_info["name"] = "Alice"

# キー "age" に値 30 を追加します
user_info["age"] = 30

print(user_info)

{'name': 'Alice', 'age': 30}

既存のキーがある場合とない場合の違い

キー指定による代入を行う際、そのキーが既に辞書内に存在するかどうかで挙動が変わります。

もし指定したキーが辞書に存在しない場合は、新しくキーと値のペアが追加されます。

一方で、既に同じ名前のキーが存在している場合は、既存の値が新しい値で上書きされます。

この特性は、値の更新（アップデート）にもそのまま利用できるため非常に便利です。

しかし、意図せず既存のデータを消去してしまうリスクもあるため、代入前にはキーの存在確認が必要なケースもあります。

updateメソッドを使った一括追加

複数の要素をまとめて辞書に追加したい場合には、update() メソッドが非常に有効です。

このメソッドを利用すると、別の辞書オブジェクトや、キーと値のペアを持つ反復可能オブジェクトを現在の辞書に統合できます。

別の辞書オブジェクトを統合する

既に存在する別の辞書にある全てのデータを、現在の辞書に追加したい場面はよくあります。

# ベースとなる辞書
profile = {"id": 1, "username": "python_user"}

# 追加したいデータを持つ辞書
additional_data = {"email": "test@example.com", "country": "Japan"}

# profileにadditional_dataの内容を統合します
profile.update(additional_data)

print(profile)

{'id': 1, 'username': 'python_user', 'email': 'test@example.com', 'country': 'Japan'}

update() メソッドも代入と同様に、重複するキーがある場合は引数として渡した側の値で上書きされます。

キーワード引数による追加

update() メソッドの引数として、直接キーワード引数を渡すことも可能です。

これにより、新しい辞書オブジェクトをわざわざ作成することなく、簡潔に要素を追加できます。

config = {"host": "localhost", "port": 8080}

# キーワード引数形式で追加・更新します
config.update(port=9000, timeout=30)

print(config)

{'host': 'localhost', 'port': 9000, 'timeout': 30}

この書き方は、キーが文字列である場合に限られますが、可読性が高く推奨される記法の一つです。

Python 3.9以降のマージ演算子と更新演算子

Python 3.9からは、辞書の統合をより直感的に行うための新しい演算子が導入されました。

これらはマージ演算子 (|) および 更新演算子 (|=) と呼ばれます。

マージ演算子 (|) による新しい辞書の生成

マージ演算子 | を使用すると、2つの辞書を結合して新しい辞書オブジェクトを生成します。

元の辞書を変更せずに、結合結果だけを得たい場合に非常に便利です。

dict_a = {"apple": 100, "banana": 200}
dict_b = {"cherry": 300, "apple": 150}

# 2つの辞書をマージして新しい辞書を作成します
# appleの値は後のdict_bのもので上書きされます
merged_dict = dict_a | dict_b

print(f"dict_a: {dict_a}")
print(f"merged: {merged_dict}")

dict_a: {'apple': 100, 'banana': 200}
merged: {'apple': 150, 'banana': 200, 'cherry': 300}

上記のように、dict_a の中身は書き換えられず、不変性が保たれている点が特徴です。

更新演算子 (|=) による破壊的な変更

一方で、既存の辞書自体を書き換えたい場合は、更新演算子 |= を使用します。

これは update() メソッドとほぼ同じ挙動を示しますが、演算子形式で記述できるためコードがスッキリします。

status = {"power": "ON", "mode": "Normal"}
updates = {"mode": "Eco", "battery": 85}

# 既存のstatusを直接更新します
status |= updates

print(status)

{'power': 'ON', 'mode': 'Eco', 'battery': 85}

update() との違いとして、更新演算子は右辺に辞書型のオブジェクト（またはそれに準ずるもの）を期待します。

setdefaultメソッドによる安全な追加

辞書に要素を追加する際、「もしキーがまだ存在しない場合のみ追加したい」という要件があります。

そのような場面で役立つのが setdefault() メソッドです。

このメソッドは、指定したキーが辞書に存在すればその値を返し、存在しなければ新しいキーと値を登録した上でその値を返します。

counts = {"apple": 1}

# "banana"は存在しないので、0をセットした上で追加します
val = counts.setdefault("banana", 0)
print(f"Added: {val}, Dictionary: {counts}")

# "apple"は既に存在するので、既存の値 1 を返し、辞書は変更されません
val2 = counts.setdefault("apple", 10)
print(f"Returned: {val2}, Dictionary: {counts}")

Added: 0, Dictionary: {'apple': 1, 'banana': 0}
Returned: 1, Dictionary: {'apple': 1, 'banana': 0}

このように、既存のデータを破壊することなく、初期値を設定したいシーンで重宝します。

各手法の比較と使い分け

ここまで紹介した手法を、用途に合わせて適切に選ぶための比較表を以下に示します。

より高度な辞書操作：collections.defaultdict

頻繁に「存在しないキーへの追加」が発生し、その都度初期値を設定するのが面倒な場合は、標準ライブラリの collections.defaultdict を検討してください。

これは、存在しないキーにアクセスした際に自動的にデフォルト値を生成してくれる辞書のサブクラスです。

from collections import defaultdict

# リストをデフォルト値とする辞書を作成
groups = defaultdict(list)

# "fruits"キーは存在しないが、自動で空リストが作成されappendされる
groups["fruits"].append("apple")
groups["fruits"].append("banana")

print(dict(groups))

{'fruits': ['apple', 'banana']}

要素を追加するコードが非常に簡潔になり、エラーを防ぐ効果も期待できます。

パフォーマンスに関する考察

Pythonの辞書はハッシュテーブルとして実装されており、要素の追加は平均して O(1) という非常に高速な計算量で動作します。

大量のデータを追加する場合でも、基本的にはパフォーマンスの劣化を心配する必要はありません。

ただし、非常に巨大な辞書同士をマージ演算子 | で結合する場合、新しい辞書オブジェクトをメモリ上に作成するため、一時的にメモリ消費量が増大することに注意してください。

メモリ効率を優先する場合は、既存の辞書を直接更新する update() メソッドや |= 演算子を選択するのが賢明です。

また、辞書のキーとして使用できるのは「不変（イミュータブル）」なオブジェクトに限られるという基本ルールも忘れないようにしましょう。

まとめ

Pythonで辞書に要素を追加する方法には、シンプルな代入からモダンな演算子まで多くの選択肢があります。

単一の要素を追加するなら dict[key] = value を使用するのが最も一般的です。

複数の要素を統合したい場合は、update() メソッドや |= 演算子が適しています。

元のデータを保護したい場合には、Python 3.9以降で利用可能な | 演算子が威力を発揮します。

さらに、特定の初期値が必要な場合は setdefault() や defaultdict を使いこなすことで、より堅牢なコードを書くことができます。

それぞれの特性を正しく理解し、読みやすく効率的なプログラミングを心がけましょう。