Pythonのリスト・辞書・内包表記の基本|使い方とよくある間違いを実例で解説
Python で複数のデータをまとめて扱うときに、いちばんよく使うのがリスト(list)と辞書(dict)です。CSV の 1 行も、Web API から受け取った JSON も、Python の中ではリストや辞書になります。
この記事では、リストと辞書の基本操作、短く書ける内包表記、そして初心者がつまずきやすい「コピーしたつもりが同じものだった」「ループ中に削除したら要素が残った」などの間違いを、実行結果つきで説明します。載せている出力は、Windows 11・Python 3.12.6 で実際に実行して確かめたものです。
リスト・辞書・タプル・セットの違い
Python には、データをまとめる型が主に 4 つあります。まずは「順番で取り出すならリスト、名前(キー)で取り出すなら辞書」と覚えれば十分です。
| 型 | 書き方 | 取り出し方 | 変更 | 主な用途 |
|---|---|---|---|---|
| リスト list | [1, 2, 3] | 番号(インデックス) | できる | 順番のあるデータの並び |
| 辞書 dict | {"name": "田中"} | キー | できる | 項目名と値の組 |
| タプル tuple | (10, 20) | 番号 | できない | 座標など、変えない組 |
| セット set | {"a", "b"} | 番号では取り出せない | できる | 重複の除去、含まれるかの判定 |
以降のコードは、sample.py などの名前で保存し、PowerShell でそのフォルダーに移動してから次のコマンドで実行できます。
py sample.py
リストの基本
作成・インデックス・負のインデックス・スライス
リストは [ ] の中に値をカンマで区切って書きます。要素の番号(インデックス)は 0 から始まり、-1 は最後、-2 は最後から 2 番目を表します。[開始:終了] と書くと、一部を切り出せます(スライス)。終了の番号の要素は含まれない点に注意してください。
fruits = ["りんご", "みかん", "ぶどう", "もも", "なし"]
print(fruits[0], fruits[2])
print(fruits[-1], fruits[-2])
print(fruits[1:3])
print(fruits[:2], fruits[3:])
print(fruits[::2])
print(fruits[::-1])
print(len(fruits))
りんご ぶどう
なし もも
['みかん', 'ぶどう']
['りんご', 'みかん'] ['もも', 'なし']
['りんご', 'ぶどう', 'なし']
['なし', 'もも', 'ぶどう', 'みかん', 'りんご']
5
[::2] は 1 つおき、[::-1] は逆順です。len() で要素の数が分かります。なお、fruits[5] のように範囲外の番号を指定すると IndexError: list index out of range になりますが、スライスは範囲外でもエラーにならず、fruits[5:] は空のリスト [] になります。
追加と削除:append・extend・insert・remove・pop
nums = [3, 1, 4]
nums.append(1)
print(nums)
nums.extend([5, 9])
print(nums)
nums.insert(0, 2)
print(nums)
nums.remove(1)
print(nums)
last = nums.pop()
print(last, nums)
first = nums.pop(0)
print(first, nums)
[3, 1, 4, 1]
[3, 1, 4, 1, 5, 9]
[2, 3, 1, 4, 1, 5, 9]
[2, 3, 4, 1, 5, 9]
9 [2, 3, 4, 1, 5]
2 [3, 4, 1, 5]
| 書き方 | やること |
|---|---|
append(x) | 最後に x を 1 つ追加 |
extend(リスト) | 最後に、別のリストの要素を 1 つずつ追加 |
insert(i, x) | i 番目の前に x を追加(0 なら先頭) |
remove(x) | 最初に見つかった x を削除(上の例では 2 つある 1 のうち前のほうだけ消えた)。なければ ValueError |
pop() / pop(i) | 最後(または i 番目)を取り出して削除し、その値を返す |
append と extend の違いは、リストを渡したときに分かります。[1, 2] に [3, 4] を append すると [1, 2, [3, 4]](リストが 1 つの要素として入る)、extend すると [1, 2, 3, 4] になります。また、extend("ab") のように文字列を渡すと、[1, 2, 'a', 'b'] と 1 文字ずつ追加されます。
ない値を remove すると、次のエラーで止まります。
ValueError: list.remove(x): x not in list
並べ替え:sort と sorted の違い
並べ替えには 2 つの方法があります。sorted(リスト) は並べ替えた新しいリストを返し、元のリストは変えません。リスト.sort() は元のリストそのものを並べ替え、戻り値は None です。
scores = [72, 95, 58, 88]
result = sorted(scores)
print(result, scores)
x = scores.sort()
print(x, scores)
scores.sort(reverse=True)
print(scores)
words = ["banana", "Kiwi", "apple", "fig"]
print(sorted(words))
print(sorted(words, key=str.lower))
print(sorted(words, key=len))
[58, 72, 88, 95] [72, 95, 58, 88]
None [58, 72, 88, 95]
[95, 88, 72, 58]
['Kiwi', 'apple', 'banana', 'fig']
['apple', 'banana', 'fig', 'Kiwi']
['fig', 'Kiwi', 'apple', 'banana']
x = scores.sort() の x が None になっている点が大事です。scores = scores.sort() と書くと、リストが None で上書きされて消えてしまいます。公式ドキュメントでも、sort は「元のリストを書き換える」ことを意識させるため、並べ替えたリストを返さないと説明されています。
文字列は文字コード順に並ぶため、大文字の Kiwi が先頭に来ます。大文字・小文字を区別せずに並べたいときは key=str.lower、長さ順なら key=len のように、key に「並べ替えの基準を作る関数」を渡します。逆順は reverse=True です。
含まれているかを調べる:in
値 in リスト で、含まれていれば True、なければ False になります。"sql" in ["Python", "SQL", "Go"] は、大文字・小文字が違うので False です。含まれていないことは not in で調べます。何番目にあるかは index()、いくつあるかは count() で分かります。
辞書の基本
作成・取得・追加・更新・削除
辞書は {キー: 値} の組を並べて作ります。値は 辞書[キー] で取り出し、同じ書き方で代入すると、キーがなければ追加、あれば上書きになります。
user = {"name": "田中", "age": 25, "lang": "Python"}
print(user["name"])
print(user.get("email"))
print(user.get("email", "未登録"))
user["email"] = "tanaka@example.com"
user["age"] = 26
print(user)
del user["lang"]
print(user)
email = user.pop("email")
print(email, user)
print(user.pop("tel", None))
print(len(user), "name" in user, "田中" in user)
田中
None
未登録
{'name': '田中', 'age': 26, 'lang': 'Python', 'email': 'tanaka@example.com'}
{'name': '田中', 'age': 26, 'email': 'tanaka@example.com'}
tanaka@example.com {'name': '田中', 'age': 26}
None
2 True False
get(キー)は、キーがないときにエラーにせず None を返します。get(キー, 初期値)とすると、ない場合はその値を返しますdel 辞書[キー]は削除するだけ、pop(キー)は削除した値を返します。pop(キー, None)のように 2 つ目を渡すと、キーがなくてもエラーになりませんinで調べるのはキーです。値の「田中」をinで調べても False になります(値を調べるなら"田中" in user.values())
keys・values・items とループ
辞書をそのまま for で回すと、取り出されるのはキーです。キーと値を両方使うときは items() を使い、for キー, 値 in 辞書.items(): と書きます。
stock = {"りんご": 3, "みかん": 0, "ぶどう": 5}
print(stock.keys())
print(stock.values())
print(stock.items())
for name in stock:
print(name)
for name, count in stock.items():
print(f"{name}: {count}個")
dict_keys(['りんご', 'みかん', 'ぶどう'])
dict_values([3, 0, 5])
dict_items([('りんご', 3), ('みかん', 0), ('ぶどう', 5)])
りんご
みかん
ぶどう
りんご: 3個
みかん: 0個
ぶどう: 5個
辞書の順番は「追加した順」
Python 3.7 からは、辞書がキーを追加した順番を保つことが言語の仕様として決まっています(公式ドキュメントの「Changed in version 3.7: Dictionary order is guaranteed to be insertion order.」)。既にあるキーの値を書き換えても順番は変わらず、一度削除して追加し直したキーは最後に回ります。
d = {"b": 2, "a": 1}
d["c"] = 3
d["b"] = 20
print(d)
del d["b"]
d["b"] = 200
print(d)
print(sorted(d))
print(dict(sorted(d.items())))
{'b': 20, 'a': 1, 'c': 3}
{'a': 1, 'c': 3, 'b': 200}
['a', 'b', 'c']
{'a': 1, 'b': 200, 'c': 3}
キーの順に並べたいときは、sorted(d)(キーのリスト)や dict(sorted(d.items()))(キー順の新しい辞書)を使います。
よく使うパターン:数を数える・グループに分ける
「単語ごとの出現回数」は、get(キー, 0) + 1 で書けます。標準ライブラリの collections.Counter を使うと、多い順の取り出しまで 1 行です。
words = ["apple", "banana", "apple", "cherry", "banana", "apple"]
counts = {}
for w in words:
counts[w] = counts.get(w, 0) + 1
print(counts)
from collections import Counter
print(Counter(words).most_common(2))
{'apple': 3, 'banana': 2, 'cherry': 1}
[('apple', 3), ('banana', 2)]
「部署ごとに名前をまとめる」ようなグループ分けは、setdefault が便利です。キーがなければ空のリストを入れてから、そのリストに追加します。
members = [
{"name": "田中", "team": "開発"},
{"name": "佐藤", "team": "営業"},
{"name": "鈴木", "team": "開発"},
]
by_team = {}
for m in members:
by_team.setdefault(m["team"], []).append(m["name"])
print(by_team)
{'開発': ['田中', '鈴木'], '営業': ['佐藤']}
この「辞書のリスト」は、JSON の配列を読み込んだときと同じ形です。JSON の中身がどんな構造になっているかを確かめたいときは、JSON 整形ツールで字下げして見ると、どこがリストでどこが辞書かが分かりやすくなります。
タプルとセット
タプルは「変更できないリスト」です。point = (10, 20) のように作り、x, y = point で一度に変数へ分けられます(アンパック)。point[0] = 99 と書き換えようとすると TypeError: 'tuple' object does not support item assignment になります。要素が 1 つのタプルは ("hello",) のようにカンマが必要で、("hello") はただの文字列です。
セットは重複を持たない集まりで、重複の除去や、含まれるかの判定に使います。
nums = [3, 1, 3, 2, 1]
print(set(nums))
print(list(dict.fromkeys(nums)))
print(type({}), type(set()))
a = {"python", "sql", "git"}
b = {"python", "go"}
print(sorted(a & b), sorted(a | b), sorted(a - b))
{1, 2, 3}
[3, 1, 2]
<class 'dict'> <class 'set'>
['python'] ['git', 'go', 'python', 'sql'] ['git', 'sql']
セットには順番の決まりがないため、元の順番を残したまま重複を消したいときは list(dict.fromkeys(nums)) を使います(辞書が追加順を保つことを利用した書き方です)。また、{} は空の辞書になるので、空のセットは set() で作ります。& は両方にあるもの、| はどちらかにあるもの、- は左にだけあるものです。文字列のセットは実行するたびに表示順が変わることがあるため、例では sorted で並べています。
内包表記で短く書く
内包表記は、「for で回して append する」処理を 1 行で書く書き方です。[式 for 変数 in 元のデータ] の形で、後ろに if 条件 を付けると、条件に合うものだけが残ります。
nums = [1, 2, 3, 4, 5, 6]
squares = []
for n in nums:
squares.append(n * n)
print(squares)
print([n * n for n in nums])
print([n for n in nums if n % 2 == 0])
print(["偶数" if n % 2 == 0 else "奇数" for n in nums])
[1, 4, 9, 16, 25, 36]
[1, 4, 9, 16, 25, 36]
[2, 4, 6]
['奇数', '偶数', '奇数', '偶数', '奇数', '偶数']
1 行目と 2 行目は同じ結果です。後ろの if は「絞り込み」、前の A if 条件 else B は「値の切り替え」で、役割が違います。前に書く場合は else が必須です。
{ } で囲み キー: 値 と書けば辞書内包表記、キー: なしならセット内包表記になります。
words = ["apple", "Banana", "cherry"]
print({w: len(w) for w in words})
print(sorted({w.lower()[0] for w in words + ["avocado"]}))
prices = {"りんご": 120, "みかん": 80, "メロン": 980}
print({k: v for k, v in prices.items() if v < 500})
print({v: k for k, v in prices.items()})
matrix = [[1, 2, 3], [4, 5, 6]]
print([x for row in matrix for x in row])
{'apple': 5, 'Banana': 6, 'cherry': 6}
['a', 'b', 'c']
{'りんご': 120, 'みかん': 80}
{120: 'りんご', 80: 'みかん', 980: 'メロン'}
[1, 2, 3, 4, 5, 6]
最後の例のように for を 2 つ並べると、二次元のリストを平らにできます(左の for が外側のループです)。ただ、for や if が 3 つ以上になるなら、普通の for 文で書いたほうが読みやすくなります。
よくある間違いと直し方
1. b = a はコピーではない
b = a は、同じリストに別の名前を付けるだけです。b を変えると a も変わります。別のリストにするには a.copy()(または a[:]、list(a))を使います。is は「同じもの(同じオブジェクト)か」を調べる演算子です。
a = [1, 2, 3]
b = a
b.append(4)
print(a, b, a is b)
c = a.copy()
c.append(5)
print(a, c, a is c)
[1, 2, 3, 4] [1, 2, 3, 4] True
[1, 2, 3, 4] [1, 2, 3, 4, 5] False
ただし copy() は外側だけをコピーする浅いコピーです。[[1, 2], [3, 4]] のようにリストの中にリストがある場合、b = a.copy() のあと b[0].append(99) とすると、a も [[1, 2, 99], [3, 4]] に変わりました。中身まで別にしたいときは、import copy して copy.deepcopy(a) を使います。辞書の copy() も同じく浅いコピーです。
2. ループ中に要素を削除する
偶数を消すつもりで、次のように書くと 2 が 1 つ残ります。削除で後ろの要素が前に詰まり、ループが次の要素を飛ばしてしまうためです。エラーにならないので気付きにくい間違いです。
nums = [1, 2, 2, 3, 4]
for n in nums:
if n % 2 == 0:
nums.remove(n)
print(nums)
[1, 2, 3]
公式チュートリアルでも、ループ中にリストを変えるより「新しいリストを作るほうが簡単で安全」とされています。nums = [n for n in nums if n % 2 != 0] とすると [1, 3] になります。
辞書の場合は、ループ中に削除すると RuntimeError: dictionary changed size during iteration で止まります。for k in list(stock): のようにキーのリストを先に作ってから回すか、辞書内包表記で残すものだけの辞書を作り直します。
3. 引数の初期値にリストを書く(def f(x=[]))
def add_item(item, items=[]):
items.append(item)
return items
print(add_item("a"))
print(add_item("b"))
print(add_item("c"))
['a']
['a', 'b']
['a', 'b', 'c']
毎回空のリストから始まるつもりが、前回の値が残っています。公式チュートリアルに「初期値は一度だけ評価される」とあるとおり、[] は関数を定義したときに 1 回だけ作られ、呼び出すたびに同じリストが使われるためです。辞書 {} でも同じことが起きます。初期値は None にして、関数の中で作ります。
def add_item(item, items=None):
if items is None:
items = []
items.append(item)
return items
print(add_item("a"))
print(add_item("b"))
こちらは ['a']、['b'] と、毎回新しいリストになりました。
4. KeyError:ないキーを [ ] で取り出した
Traceback (most recent call last):
...
print(user["email"])
~~~~^^^^^^^^^
KeyError: 'email'
KeyError: の後ろが、見つからなかったキーです。キーの綴りや大文字・小文字、前後の空白を確認します。データによってキーがあったりなかったりする場合は、user.get("email") や if "email" in user: で分けて書きます。
5. 二次元リストを [[0] * 3] * 3 で作る
grid = [[0] * 3] * 3
grid[0][0] = 1
print(grid)
print(grid[0] is grid[1])
grid = [[0] * 3 for _ in range(3)]
grid[0][0] = 1
print(grid)
[[1, 0, 0], [1, 0, 0], [1, 0, 0]]
True
[[1, 0, 0], [0, 0, 0], [0, 0, 0]]
1 か所だけ変えたのに、3 行すべての先頭が 1 になりました。* 3 は中のリストをコピーせず、同じリストを 3 回並べるだけだからです(公式ドキュメントでも「初心者がよく悩まされる」と注意されています)。二次元リストは、内包表記で 1 行ずつ新しいリストを作ります。なお、[0] * 3 のように中身が数値や文字列なら問題ありません。
よくある質問
辞書のキーにリストは使えますか?
使えません。{["a", "b"]: 1} は TypeError: unhashable type: 'list' になります。キーには文字列・数値・タプルのような変更できない値を使います。2 つの値の組をキーにしたいときは {("a", "b"): 1} のようにタプルにします。
リストと辞書、どちらを使えばよいですか?
「1 件のデータの項目(名前・年齢など)」は辞書、「同じ形のデータが何件も並ぶ」ならリストが基本です。社員一覧なら「辞書のリスト」になります。また、大量のデータから特定の値を何度も探す場合、リストの in は先頭から順に調べますが、辞書やセットの in はキーから直接探すため、件数が多いほど速くなります。
まとめ
- リストは 0 から数える。
-1は最後、[開始:終了]の終了は含まない sorted()は新しいリストを返し、sort()は元を書き換えて None を返す- 辞書のないキーは
get()で安全に取り出す。キーと値のループはitems() b = aはコピーではない。初期値に[]を書かない。二次元リストは内包表記で作る
関連する記事・ツール
- JSON整形ツール
- PythonでJSONを扱う方法|json.loads・dumpsの使い方とエラー対処
- PythonでCSVを読み書きする方法|csvモジュールとExcelの文字化け・空行対策
- Pythonのファイル読み書き|open・with・encoding指定と文字化けの直し方
- Pythonの仮想環境venvの使い方|Windows・Linuxでの作成と有効化を解説
- Pythonの例外処理入門|try・except・finally・raiseの使い方
- Pythonのf文字列(f-string)の使い方|書式指定・桁区切り・ゼロ埋めを実例で解説