【Python】辞書をマージする3つの方法

# Python 3.9+
# 基本のマージ: 新しい辞書が返る(元のa, bは変わらない)

a = {"x": 1, "y": 2}
b = {"y": 99, "z": 3}

c = a | b  # 新しい辞書を作成

print("a:", a)            # 元のaはそのまま
print("b:", b)            # 元のbもそのまま
print("c:", c)            # マージ結果
print("a is c:", a is c)  # 別オブジェクトかを確認

# 右辺(b)が勝つ例
a = {"k": 1, "list": [1, 2], "inner": {"a": 1}}
b = {"k": 2, "list": ["x"], "inner": {"b": 2}}

c = a | b
print(c)

# Python 3.9+
# 破壊的なマージ: a自体が更新される

a = {"x": 1, "y": 2}
b = {"y": 99, "z": 3}

before_id = id(a)
a |= b  # aを更新(破壊的)

print("a:", a)
print("id(a)は変わらないか:", before_id == id(a))

# 引数の受け付け方の違い

# |= は「マッピング(辞書)」が必要
x = {"a": 1}
x |= {"b": 2}  # OK

try:
    x |= [("c", 3)]  # リストのタプル(イテラブル)はNG → TypeError
except TypeError as e:
    print("TypeError:", e)

# update はイテラブルやキーワード引数もOK
y = {"a": 1}
y.update([("c", 3)])  # OK
y.update(d=4)         # キーワード引数もOK
print("y:", y)

# Python 3.5+
# アンパックで新しい辞書を作成

a = {"x": 1, "y": 2}
b = {"y": 99, "z": 3}

c = {**a, **b}  # 後から展開されたbが勝つ
print(c)

# 浅いマージの挙動(ネストは置き換え)

cfg1 = {"db": {"host": "localhost", "port": 5432}, "debug": True}
cfg2 = {"db": {"port": 6543}}  # portだけ変えたいケース

merged_pipe = cfg1 | cfg2      # 3.9+
merged_unpack = {**cfg1, **cfg2}  # 3.5+

print("merged_pipe:", merged_pipe)
print("merged_unpack:", merged_unpack)

# 簡易的な「部分的に深い」マージ例(必要なキーだけネストを個別にマージ)

cfg1 = {"db": {"host": "localhost", "port": 5432}, "debug": True}
cfg2 = {"db": {"port": 6543}}

merged = {**cfg1, **cfg2}
# "db" は両方にあるので、ネストを個別にマージする
if "db" in cfg1 and "db" in cfg2:
    merged["db"] = {**cfg1["db"], **cfg2["db"]}

print(merged)

# 簡易ベンチマーク(環境により結果は異なるため目安)
import timeit

setup = """
a = {str(i): i for i in range(1000)}
b = {str(i): -i for i in range(500, 1500)}
"""

print("a | b:", timeit.timeit("a | b", setup=setup, number=1000))
print("{**a, **b}:", timeit.timeit("{**a, **b}", setup=setup, number=1000))
print("c=a.copy(); c.update(b):", timeit.timeit("c=a.copy(); c.update(b)", setup=setup, number=1000))
print("a_copy=a.copy(); a_copy|=b:", timeit.timeit("a_copy=a.copy(); a_copy|=b", setup=setup, number=1000))