Python辞書update()メソッドの使い方と注意点

2026.09.21 2026.09.21

Pythonで辞書データを効率的に更新したい場合、update()メソッドが最適です。このメソッドを使用することで、既存の辞書に対して別の辞書やキー・値のペアを簡単に追加・更新できます。本記事では、update()メソッドの基本的な使い方から複数の引数形式、そして初心者がつまずきやすいネストされた辞書の扱いまで、実務で役立つポイントを解説します。

update()メソッドとは

update()メソッドは、辞書オブジェクトに対して一括でデータを追加または更新するための組み込みメソッドです。既存のキーが存在する場合は値を上書きし、存在しないキーの場合は新規に追加します。1件ずつ代入文を書く必要がなく、複数のキーと値をまとめて反映できる点が最大のメリットです。

こんな場面で役立ちます

update()メソッドは、特に次のような課題を抱えているときに効果を発揮します。

複数の辞書をまとめる作業の効率化
デフォルト設定とユーザー設定の上書き結合
キー数が可変なAPIレスポンスなどの反映

これらの処理をfor文でキーを1つずつ取り出して代入していくと、コード量が増えるだけでなく可読性も下がってしまいます。update()メソッドを使えば、こうした処理を1行で簡潔に書くことができます。

基本的な使い方

# 基本例
dict1 = {'a': 1, 'b': 2}
dict2 = {'c': 3, 'd': 4}

dict1.update(dict2)
print(dict1)  # {'a': 1, 'b': 2, 'c': 3, 'd': 4}

上記の例では、dict1に対してdict2の内容をupdate()メソッドで反映しています。dict1にはもともと'c'や'd'というキーが存在しませんでしたが、update()メソッドを実行することで新しいキーとして追加されています。

主な特徴

既存のキーは上書きされる

dict1 = {'a': 1, 'b': 2}
dict2 = {'b': 99, 'c': 3}

dict1.update(dict2)
print(dict1)  # {'a': 1, 'b': 99, 'c': 3}

dict1とdict2の両方に存在する'b'というキーは、dict2側の値である99で上書きされています。一方、dict1にしかない'a'や、dict2にしかない'c'はそのまま残ります。この「重複するキーは後から渡した値で上書きされる」という挙動を理解しておくと、意図しないデータの書き換えを防げます。

複数の引数形式に対応

dict1 = {'a': 1}

# 辞書を渡す
dict1.update({'b': 2})

# キーワード引数を使う
dict1.update(c=3, d=4)

# タプルのリストを渡す
dict1.update([('e', 5), ('f', 6)])

print(dict1)  # {'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5, 'f': 6}

update()メソッドは辞書オブジェクトだけでなく、キーワード引数や、キーと値のペアを並べたタプルのリストも受け取れます。変数名がそのままキー名になる場合はキーワード引数形式、キーが動的に決まる場合は辞書やタプルのリストを渡す形式など、状況に応じて使い分けると読みやすいコードになります。

戻り値

update()メソッドはNoneを返します(元の辞書を直接変更します)。

dict1 = {'a': 1}
result = dict1.update({'b': 2})
print(result)  # None
print(dict1)   # {'a': 1, 'b': 2}

update()メソッドは元の辞書そのものを書き換える「破壊的メソッド」であり、更新後の辞書を新しい戻り値として返すわけではありません。そのため、result = dict1.update({'b': 2})のように戻り値を変数へ代入しても、resultには更新後の辞書ではなくNoneが入ってしまいます。更新後の辞書を確認したい場合は、update()を実行した後の元の辞書(この例ではdict1)をそのまま参照するようにしてください。

辞書の結合

update()メソッドを使用すると、複数の辞書を効率的に結合できます。この機能は、デフォルト設定とユーザー設定を統合する際に特に有用です。

使用例

以下の例では、デフォルト設定にユーザー設定を上書き結合しています。既存のキーは新しい値で更新され、存在しないキーはそのまま保持されます。

# 設定のマージ
default_config = {'timeout': 30, 'retry': 3}
user_config = {'timeout': 60}

default_config.update(user_config)
print(default_config)  # {'timeout': 60, 'retry': 3}

ネストされた辞書を扱う際の注意点

update()メソッドは、辞書の一番上の階層(トップレベル)にあるキーだけを比較して上書きする点に注意が必要です。値がさらに辞書になっている「ネストされた辞書」の場合、中身を1つずつマージするのではなく、そのキーの値ごと丸ごと置き換えてしまいます。
たとえば、設定情報を{'db': {'host': 'localhost', 'port': 5432}}のような階層構造で管理している場合、update()で{'db': {'port': 5433}}を渡すと、'host'を含めて'db'キーの値全体が{'port': 5433}に置き換わってしまい、意図せず'host'の設定が消えてしまいます。階層構造を持つ辞書を安全にマージしたい場合は、階層ごとに個別へupdate()を呼び出すか、再帰的にマージ処理を行う関数を用意するなどの対応が必要です。

まとめ

update()メソッドを使うことで、以下のようなメリットが得られます。

複数のキーと値の一括追加・更新
辞書型・キーワード引数・タプルのリストなど複数の形式への対応
デフォルト設定とユーザー設定のマージなど実務処理の簡潔な記述

一方で、ネストされた辞書はトップレベルのキーごと丸ごと置き換わってしまう点には注意が必要です。用途に応じてupdate()メソッドを正しく使い分け、辞書更新の処理を効率化していきましょう。

コメントコメントをキャンセル

Pythonで標準Queueを使わずdequeとConditionで高速キューを実装する技術