リストが番号付きボックスの行である場合、Python 辞書 はラベル付きのボックスのセットです。必要なものを位置ではなく名前で要求します。そのため、辞書は JSON データ、構成、キャッシュ、および Python 自体の多くの背後に配置されます。

このチュートリアルは基本から始まり、経験豊富な開発者が毎日使用するパターンに進みます。すべての例を Python 3.13 で実行し、示されている出力はその実行からのものです。

辞書とは何ですか?

辞書、つまり dict は、キーを値にマッピングします。各キーは 1 回だけ出現し、値はリストや他の辞書を含む任意の値にすることができます。

Python 3.7 以降、辞書は正式に挿入順序を保持します。古いチュートリアルの多くは依然としてそれらを順序なしと呼んでいますが、これはもはや真実ではありません。他の型のより広範な比較については、Python リスト、タプル、セット を参照してください。

辞書はハッシュ テーブルを使用するため、検索は高速です。キーのチェックには、辞書に項目が 10 個でも 100 万個でもほぼ同じ時間がかかりますが、リストの検索はサイズが大きくなるにつれて遅くなります。

辞書を作成する

user = {"name": "Asha", "age": 31, "city": "Pune"}

empty = {}
from_keywords = dict(name="Asha", age=31)
from_pairs = dict([("a", 1), ("b", 2)])

中括弧は最も一般的な形式です。 1 つの罠: {} は空のセットではなく、空の辞書を作成します。空のセットの場合は set() が必要です。

値を安全に読み取る

値を読み取るには 2 つの方法があり、キーが存在しない可能性がある場合にはその違いが重要になります。

user["name"]                  # 'Asha'
user["email"]                 # KeyError: 'email'

user.get("email")             # None
user.get("email", "not set")  # 'not set'

キーが存在する必要がある場合は角括弧を使用して、キーが見つからない場合に大声で失敗するようにします。 API 応答のオプション フィールドなど、欠席が通常の場合は get() を使用します。キーを確認するには、値ではなくキーを調べる in 演算子を使用します。

"city" in user    # True
"Pune" in user    # False

追加、更新、削除

キーに割り当てると、キーが存在する場合は更新され、存在しない場合は追加されます。

user["age"] = 32
user["email"] = "asha@example.com"
print(user)

# {'name': 'Asha', 'age': 32, 'city': 'Pune', 'email': 'asha@example.com'}

Python では、項目を削除するいくつかの方法が提供されています。

user.pop("city")          # returns 'Pune' and removes it
user.pop("phone", None)   # no error if it is missing
del user["email"]         # removes it, and raises KeyError if missing
user.clear()              # empties the dictionary

値を戻したい場合はpop()を使用します。 2 番目の引数としてデフォルトを渡すと、キーが存在しない場合のエラーが回避されます。 popitem() は、最後に追加されたペアを削除して返します。

辞書をループする

ループするとキーが直接得られます。キーと値の両方を取得するには、items() を使用します。

user = {"name": "Asha", "age": 32}

for key, value in user.items():
    print(key, "=", value)

# name = Asha
# age = 32

keys()、values()、items() はコピーではなくライブビューを返すため、後の変更が反映されます。 Python では RuntimeError が発生するため、辞書のループ中にキーを追加または削除しないでください。必要な場合は list(user) をループします。

辞書メソッドのチートシート

辞書を結合する

一般的なニーズは、デフォルトに加えてユーザー設定を適用することです。キーが衝突すると、右側が勝ちます。

defaults = {"theme": "light", "lang": "en"}
saved = {"theme": "dark"}

defaults | saved
{**defaults, **saved}

# Both give: {'theme': 'dark', 'lang': 'en'}

| 演算子には Python 3.9 以降が必要ですが、** バージョンは古いバージョンでも動作します。どちらも新しい辞書を作成します。対照的に、defaults.update(saved)とdefaults |= savedはdefaultsをその場で変更します。

内訳と並べ替え

辞書内包表記は、リスト内包表記 がリストに対して行うのと同様に、読み取り可能な 1 行で新しい辞書を作成します。

prices = {"pen": 10, "book": 250, "bag": 900}

{k: v for k, v in prices.items() if v > 100}
# {'book': 250, 'bag': 900}

値で並べ替えるには、key 関数を sorted() に渡します。最大値を持つキーを見つけるには、max() を使用します。

sorted(prices.items(), key=lambda item: item[1], reverse=True)
# [('bag', 900), ('book', 250), ('pen', 10)]

max(prices, key=prices.get)
# 'bag'

辞書には sort() メソッドはなく、sorted() はペアのリストを返します。この順序で辞書が必要な場合は、結果を dict() で囲みます。

パターンのカウントとグループ化

2 つのタスクが常に発生します。 1 つ目はカウントです。これは、デフォルトのゼロで get() を使用して実行できます。

words = "to be or not to be".split()

counts = {}
for word in words:
    counts[word] = counts.get(word, 0) + 1

print(counts)
# {'to': 2, 'be': 2, 'or': 1, 'not': 1}

標準ライブラリでは、Counter でこれをさらに短くしています。

from collections import Counter

Counter(words).most_common(2)
# [('to', 2), ('be', 2)]

2 番目はグループ化で、欠損値を作成するため、ここでは defaultdict が理想的です。

from collections import defaultdict

orders = [("Asha", 1200), ("Ben", 300), ("Asha", 800)]

by_customer = defaultdict(list)
for name, total in orders:
    by_customer[name].append(total)

print(dict(by_customer))
# {'Asha': [1200, 800], 'Ben': [300]}

これがないと、追加する前に各キーが存在するかどうかを確認する必要があります。これらと同じパターンは、API データまたはログ行を集約する場合にうまく機能します。辞書が空であるかキーが欠落している場合、Python 例外処理に関するガイド では、結果として生じる KeyError の対処方法を示しています。

ネストされたデータとコピー トラップ

JSON はネストされた辞書とリストに直接マッピングされるため、キーをチェーンすることがよくあります。チェーン get() は、レベルが欠落している可能性がある場合にこれを安全に保ちます。

response = {"user": {"profile": {"city": "Pune"}}}

response["user"]["profile"]["city"]               # 'Pune'
response.get("user", {}).get("settings", {}).get("theme")   # None

ネストされたデータをコピーするときは注意してください。 copy() は最上位レベルのみを複製するため、内部辞書は元の辞書と共有されたままになります。

settings = {"db": {"host": "localhost"}}

shallow = settings.copy()
shallow["db"]["host"] = "prod"

print(settings["db"]["host"])
# prod

コピーを変更するとオリジナルも変更されるため、厄介なバグになる可能性があります。完全に独立したコピーを取得するには、copy.deepcopy(settings) を使用します。

辞書キーには何が考えられますか?

キーは ハッシュ可能 である必要があります。これは通常、不変を意味します。文字列、数値、不変値のタプルはすべて機能します。リストと辞書では次のことはできません。

{["a"]: 1}

# TypeError: unhashable type: 'list'

その理由は、キーのハッシュによって値が保存される場所が決定されるためです。キーが変更される可能性がある場合、Python はそのキーを見つけることができなくなります。複合キーが必要な場合は、{("Pune", 2026): 120} などのタプルを使用します。

よくある間違い

• オプションのキーに角かっこを使用します。キーが存在しない可能性がある場合は、get()に手を伸ばします。
• get() がキーが存在することを意味すると仮定します。 None は、欠落しているか、保存されている None を意味する可能性があります。違いが重要な場合は in を使用してください。
• 変更可能なデフォルトを使用します。 dict.fromkeys(names, []) すべてのキーにまったく同じリストが与えられます。代わりに内包表記を使用してください。
• 反復中にサイズを変更します。 キーのコピーをループします。
• 固定の既知のフィールドに辞書を使用する。 dataclass はより明確であり、フィールド名のタイプミスを検出します。

まとめ

辞書は少し練習すると報われます。オプションのキーには get()、ループには items()、最も一般的な 2 つのジョブには Counter と defaultdict を覚えておいてください。練習するには、小さな JSON ファイルを取得し、そのレコードをカウントしてグループ化するコードを作成します。この言語を初めて使用する場合は、初心者向けの Python チュートリアルから始めてください。

よくある質問

学び続ける