Python辞書の使い方入門|dictの作成・取得・追加・削除を実行例で解説
「Pythonの辞書(dict)は何に使うのか分からない」「値を取り出そうとしたらKeyErrorで止まってしまった」という悩みを持つ方は多いです。
この記事では、Python 辞書 使い方を、Python辞書型の初心者の方向けに順を追って解説します。辞書の作成、キーと値の取得、追加・更新・削除、ループ処理といった基本から、コピー・ソート・結合・JSON連携などの応用まで、コードと実行結果をセットで紹介します。
最初に要点を3つにまとめます。
- 辞書は「キー」で値を引くデータ構造で、名前やIDで情報を管理したいときに向いています
- キーが無いかもしれない場面では
[]ではなくget()を使うとエラーを防げます - 辞書の結合はPython 3.9以降なら
|演算子が最も簡潔に書けます
※サンプルコードはPython 3.9以降を前提にしています。
1. Python辞書(dict)の使い方の基本:辞書とは?
キーと値のペアでデータを管理する
辞書は「キー」と「値」を対応づけて保存するデータ構造です。波括弧{}の中にキー: 値をカンマ区切りで並べます。
user = {'name': '山田', 'age': 28, 'city': '東京'}
print(user['name'])
# 実行結果: 山田
辞書の特徴として、paizaラーニングの解説では「同じキーは重複できないが、値は重複可能」「キーを指定することで高速な検索や更新が可能」「Python 3.7以降はデータの順序が保持される」と整理されています。
リストとの違い
リストは「0番目、1番目…」という位置(インデックス)で値を取り出します。一方、辞書は「'name'」のような名前(キー)で値を取り出します。
| 比較項目 | リスト(list) | 辞書(dict) |
|---|---|---|
| 値の取り出し方 | インデックス(a[0]) |
キー(d['name']) |
| 作成時の記号 | 角括弧[] |
波括弧{} |
| 重複 | 値の重複可 | キーは重複不可、値は重複可 |
| 向いている用途 | 順番に並んだデータ | 名前・IDで引くデータ |
たとえば社員100人の年齢をリストで持つと「何番目が誰か」を別に覚える必要がありますが、辞書ならages['山田']のように直接取り出せます。
キーに使えるデータ型
キーには、文字列・数値・タプルなど変更できない(イミュータブルな)データしか使えません。リストや辞書はキーにできません(東京大学のPythonプログラミング入門)。値のほうは、数値・文字列・リスト・辞書など何でも入れられます。
また、同じキーを2回書くと後から書いた値で上書きされます。
d = {'key1': 1, 'key1': 2}
print(d)
# 実行結果: {'key1': 2}
2. 辞書の作成とキー・値の取得方法
{}とdict()で辞書を作る
辞書の作り方は主に2種類です。
# 波括弧で作成
scores = {'国語': 80, '数学': 92}
# dict()関数で作成(キーワード引数)
scores2 = dict(国語=80, 数学=92)
# タプルのリストから作成
scores3 = dict([('国語', 80), ('数学', 92)])
# 空の辞書
empty = {} # または dict()
print(scores == scores2 == scores3)
# 実行結果: True
なお、dict()のキーワード引数では、ifなどの予約語や数値をキーにできないという制約があります。数値キーを使いたい場合は{}で書きましょう。
[ ]で値を取得する(KeyErrorに注意)
Pythonでキーから値を取得する最も基本的な方法は辞書[キー]です。ただし、存在しないキーを指定するとKeyErrorが発生し、プログラムが停止します。
user = {'name': '山田'}
print(user['age'])
# 実行結果: KeyError: 'age'
get()で安全に値を取得する
get()メソッドは、キーが無いときにエラーではなくNoneを返します。第2引数でデフォルト値も指定できます。
user = {'name': '山田'}
print(user.get('age'))
# 実行結果: None
print(user.get('age', 0))
# 実行結果: 0
coddy.techの解説では、「キーが絶対に存在するはず」のときは[]、「キーが無いこともある」のが正常なときはget()という使い分けが紹介されています。[]はバグに早く気づける、get()は止まらない、とそれぞれ利点があるわけです。
3. 辞書に要素を追加・更新・削除する方法
代入で追加・更新する
新しいキーに代入すると追加、既存のキーに代入すると更新になります。
user = {'name': '山田'}
user['age'] = 28 # 追加
user['name'] = '佐藤' # 更新
print(user)
# 実行結果: {'name': '佐藤', 'age': 28}
setdefault()とupdate()
setdefault()は、キーが無ければ登録して値を返し、既にあれば何もせず既存の値を返します。
count = {'りんご': 3}
count.setdefault('みかん', 0)
count.setdefault('りんご', 0) # 既存なので無視される
print(count)
# 実行結果: {'りんご': 3, 'みかん': 0}
update()は複数の要素をまとめて追加・更新します。同じキーは引数側の値で上書きされます。
count.update({'りんご': 5, 'ぶどう': 2})
print(count)
# 実行結果: {'りんご': 5, 'みかん': 0, 'ぶどう': 2}
del・pop()・popitem()・clear()で削除する
削除方法は目的別に4つあります。
d = {'a': 1, 'b': 2, 'c': 3, 'd': 4}
del d['a'] # 指定キーを削除
v = d.pop('b') # 削除して値を受け取る
print(v)
# 実行結果: 2
print(d.pop('z', None)) # 無いキーでもエラーにしない
# 実行結果: None
item = d.popitem() # 最後に追加された要素を削除
print(item)
# 実行結果: ('d', 4)
d.clear() # 全要素を削除
print(d)
# 実行結果: {}
値が不要ならdel、削除した値を使いたいならpop()と覚えておくと迷いません。
4. 辞書の存在確認とループ処理
in演算子でキーの存在を確認する
inで調べられるのはキーです。値を確認したいときはvalues()を使います。
user = {'name': 'Rosa', 'age': 30}
print('name' in user) # 実行結果: True
print('Rosa' in user) # 実行結果: False(値なので)
print('Rosa' in user.values()) # 実行結果: True
要素数はlen(user)で取得できます(この例では2)。
keys()・values()・items()の違い
| メソッド | 取り出せるもの | 例の結果 |
|---|---|---|
keys() |
キーの一覧 | dict_keys(['name', 'age']) |
values() |
値の一覧 | dict_values(['Rosa', 30]) |
items() |
(キー, 値)のペア | dict_items([('name', 'Rosa'), ('age', 30)]) |
for文でキーと値を同時に取り出す
実務で最もよく使うのはitems()です。
scores = {'国語': 80, '数学': 92, '英語': 75}
for subject, score in scores.items():
print(f'{subject}: {score}点')
# 実行結果:
# 国語: 80点
# 数学: 92点
# 英語: 75点
for key in scores:と書けばキーだけ、for v in scores.values():と書けば値だけを順に取り出せます。
5. 辞書の応用テクニック(コピー・ソート・内包表記・結合)
copy()とdeepcopy()の違い
b = aと書くだけでは同じ辞書を2つの名前で指しているだけで、bを変えるとaも変わります。別物にするにはコピーが必要です。
import copy
a = {'tags': ['python', 'dict']}
shallow = a.copy() # 浅いコピー
deep = copy.deepcopy(a) # 深いコピー
a['tags'].append('json')
print(shallow['tags'])
# 実行結果: ['python', 'dict', 'json'](中のリストは共有)
print(deep['tags'])
# 実行結果: ['python', 'dict'](完全に独立)
値にリストや辞書が入っている場合はdeepcopy()を使うのが安全です。
sorted()でソートし、内包表記で変換する
辞書は挿入順を保つため、「ソート」とは並べ替えた順で新しい辞書を作ることを意味します。
scores = {'国語': 80, '数学': 92, '英語': 75}
# 値の大きい順に並べ替え
ranked = dict(sorted(scores.items(), key=lambda x: x[1], reverse=True))
print(ranked)
# 実行結果: {'数学': 92, '国語': 80, '英語': 75}
# 辞書内包表記:80点以上だけ抽出
passed = {k: v for k, v in scores.items() if v >= 80}
print(passed)
# 実行結果: {'国語': 80, '数学': 92}
辞書内包表記は「条件で絞り込む」「値をまとめて変換する」場面で、for文の数行を1行にできます。
辞書同士を結合する(update / ** / |)
| 方法 | 元の辞書 | 対応バージョン |
|---|---|---|
a.update(b) |
aを書き換える |
全バージョン |
{**a, **b} |
新しい辞書を作る | Python 3.5以降 |
a \| b |
新しい辞書を作る | Python 3.9以降 |
default = {'theme': 'light', 'lang': 'ja'}
user_conf = {'theme': 'dark'}
print(default | user_conf)
# 実行結果: {'theme': 'dark', 'lang': 'ja'}
いずれも同じキーは右側(後ろ)の値が優先されます。「初期設定をユーザー設定で上書きする」処理にぴったりです。
6. ネスト構造・JSON連携とよくあるエラー
辞書の中に辞書・リストを入れる
値には辞書やリストも入れられるため、複雑なデータも表現できます。
users = {
'u001': {'name': '山田', 'skills': ['Python', 'SQL']},
'u002': {'name': '佐藤', 'skills': ['Java']},
}
print(users['u001']['skills'][0])
# 実行結果: Python
print(users.get('u003', {}).get('name', '不明'))
# 実行結果: 不明
get()をつなげると、途中のキーが無くてもエラーになりません。
JSONデータとの関係
Web APIのレスポンスや設定ファイルで使われるJSONは、辞書とほぼ同じ形をしています。標準ライブラリのjsonで相互変換できます。
import json
text = '{"name": "山田", "age": 28}'
data = json.loads(text) # JSON文字列 → 辞書
print(data['name'])
# 実行結果: 山田
print(json.dumps(data, ensure_ascii=False)) # 辞書 → JSON文字列
# 実行結果: {"name": "山田", "age": 28}
辞書を使いこなせると、API連携やデータ処理のコードが一気に書きやすくなります。
よくあるエラーと対処法
Q. KeyErrorが出ます。
A. 存在しないキーを[]で指定しています。get()を使うか、if 'key' in d:で事前に確認しましょう。
Q. TypeError: unhashable type: 'list'が出ます。
A. リストをキーにしています。リストは変更可能なためキーにできません。tuple()でタプルに変換すれば使えます。
d = {tuple([1, 2]): '座標'}
print(d[(1, 2)])
# 実行結果: 座標
Q. 辞書の順番は保証されますか?
A. Python 3.7以降は、要素を追加した順番が保持される仕様です。
まとめ
Pythonの辞書(dict)の使い方を、基本から応用まで解説しました。
- 辞書はキーと値のペアで管理し、キーには変更できない型(文字列・数値・タプル)を使う
- 作成は
{}かdict()、取得は[]、キーが無いかもしれないときはget() - 追加・更新は代入、まとめて更新は
update()、削除はdel・pop()・popitem()・clear() - ループは
items()でキーと値を同時に取り出すのが定番 - 応用として、コピーは
deepcopy()、ソートはsorted()、結合はPython 3.9以降なら|演算子が便利 - JSONとの相互変換で、API連携や設定管理に活用できる
まずは身近なデータ(家計簿の費目と金額、テストの科目と点数など)を辞書にして、取得・追加・ループを実際に試してみてください。手を動かすことで、辞書の便利さがすぐに実感できるはずです。

コメント