PythonのIndexErrorの直し方|リストの番号とlenを図解

PythonのIndexError: list index out of rangeは、リストにない番号の要素を取り出そうとしたときなどに出るエラーです。3個のリストなら、0以上の番号は0・1・2。len(items)が返す3は個数で、最後の番号ではありません。まずエラーの行にある番号と、その時点の個数を比べましょう。

IndexErrorを直すとき、まず見る3点

  1. どのリストか:エラーの行で取り出しているリストを探す。
  2. 今、何個あるか:取り出す直前にprint(len(items))で個数を見る。空になっていないかも確認する。
  3. 何番を使っているか:print(index)で番号を見る。個数ではなく、有効な番号を指定する。

ここではitems = ["地図", "鍵", "ポーション"]を使います。エラーを消すことだけを目指さず、どの道具を取りたかったかも確かめましょう。

書き方 この3個のリストでの結果
len(items) 3(個数)
items[2] ポーション(0から数えた最後)
items[3] IndexError(3番はない)
items[-1] ポーション(後ろから1個目)
items[-4] IndexError(後ろからも範囲外)

初めてリストを見る人は、リストの作り方・追加・入れ替えから始められます。エラー全体の読み方はエラー名と行番号の教材へ。

IndexErrorの原因を3つの実験で確かめよう

最初の見本は動くコードです。結果を予想して実行し、番号を1か所変えてエラーも観察します。赤い案内が出ても、直してもう一度試せます。

今のコードを残す

表示中の実験のコードを保存します。ページを離れると編集内容は消えます。

今のコードを残す

表示中の実験のコードを保存します。ページを離れると編集内容は消えます。

保存した.pyファイルを、VS Codeで動かす方法(別タブ)

無料・ログイン不要。PCの最新版Chrome・Edgeを推奨します。初回は読み込みに少し時間がかかります。困ったら「停止する」「元に戻す」を使えます。編集したコードはページを閉じると消えるため、残したいものはコピーしてください。

図解:lenの個数と、前後からの番号

3個のリストの番号は前から0・1・2、後ろから-3・-2・-1。lenは3を返します。3番と-4番は範囲外で、空なら0番も-1番も取り出せません。
3個のリストの番号は前から0・1・2、後ろから-3・-2・-1。lenは3を返します。3番と-4番は範囲外で、空なら0番も-1番も取り出せません。

1.3個の道具に、3番はある?

予想:個数は3です。最後の道具を取り出す番号はいくつでしょう?

items = ["地図", "鍵", "ポーション"]
index = 2
print("個数:", len(items))
print("取り出す番号:", index)
print("道具:", items[index])

indexが2ならポーションを取り出せます。3にすると、3番の場所はないのでIndexErrorになります。エラーの前に表示した個数と番号を比べると、原因を追えます。

見本の結果を確かめる
個数: 3
取り出す番号: 2
道具: ポーション

変えてみよう:indexを2から3に変えて実行します。エラーの行を見てから、最後の道具を取れる番号に直しましょう。

考えるヒント

0以上の番号は0、1、2。len(items)は個数で、最後の番号ではありません。

2.最後の道具は、-1でも取れる

予想:2番と-1番は、同じ道具でしょうか? -3番はどの道具でしょう?

items = ["地図", "鍵", "ポーション"]
print("最後:", items[-1])
print("後ろから3個目:", items[-3])

負の番号は後ろから数える書き方です。この3個では-1がポーション、-3が地図です。持ち物を最後に追加すると、-1が指す道具も変わります。負の番号にも範囲があります。

見本の結果を確かめる
最後: ポーション
後ろから3個目: 地図

変えてみよう:-3を-4に変えて実行し、結果を見ます。その後、見本に戻して持ち物を1個追加すると、-1は何を指しますか?

考えるヒント

後ろからは-1、-2、-3と数えます。3個のリストに-4番はありません。

3.1番から選べる、道具メニュー

予想:メニューの3番を選ぶと、リストでは何番を使うでしょう? 0を選ぶとどうなるでしょう?

items = ["地図", "鍵", "ポーション"]
choice = 3
index = choice - 1

if 1 <= choice <= len(items):
    print("選んだ道具:", items[index])
else:
    print("その番号は選べません")

このメニューでは1〜3を選び、リストには0〜2の番号を使います。範囲を確かめてから取り出すため、0や4では案内だけを表示します。0をそのまま1引くと-1になり最後の道具を取れてしまうので、下限も確認します。

見本の結果を確かめる
選んだ道具: ポーション

変えてみよう:choiceを1・3・4・0に変えて比べます。次にitemsを空のリスト[]にし、choiceを1に戻して試しましょう。

考えるヒント

画面の1番をリストの0番に直すため、1を引きます。取り出す前に、1以上で個数以下かを確認しています。

実験3ではchoiceに整数を使います。1 <= choice <= len(items)は「1以上、かつ個数以下」です。Pythonのリストは負の番号も使えますが、このメニューの選択番号は1からにしています。

空のリストでは、0番も-1番も取れない

空のリスト[]は個数が0で、取り出せる要素がありません。items[0]もitems[-1]もIndexErrorになります。最後の1個を使いたいなら、中身があることを先に確かめます。

items = []
if len(items) > 0:
    print("最後の道具:", items[-1])
else:
    print("持ち物はまだありません")

変えてみよう:[]を["地図"]に変え、1個ある場合と比べましょう。0個のときにはlen(items) - 1も-1になるだけで、取り出せる場所が増えるわけではありません。

for文の最後だけIndexErrorになるとき

range(len(items) + 1)で番号を作っていないか確認します。3個のリストでrange(4)を使うと0・1・2・3となり、最後の3が範囲外です。番号を使うならrange(len(items))で0・1・2を作れます。中身を順に表示するだけなら、番号を作らずに書けます。

items = ["地図", "鍵", "ポーション"]
for item in items:
    print("確認:", item)

このforは空のリストなら中の処理を0回実行します。番号も必要なときは、次のように個数に合わせます。

items = ["地図", "鍵", "ポーション"]
for index in range(len(items)):
    print(index, items[index])

この例は、繰り返している途中にリストを増減しません。途中でremoveやpopを使うと、残りの個数や番号が変わるため別の注意が必要です。詳しくはrangeの始まり・終わり・増減へ。

IndexErrorでよくある疑問

list assignment index out of rangeも同じ原因?

items[3] = "ランタン"のように、存在しない場所へ代入してもIndexErrorになります。番号への代入は、すでにある要素を入れ替える操作です。末尾へ1個追加するならitems.append("ランタン")を使います。

負の番号は、すべてエラーになりますか?

いいえ。3個なら-1・-2・-3を使えます。一般に個数がnの空でないリストでは、-nからn-1までが要素を取り出せる整数の番号です。最初は前から0・1・2、後ろから-1・-2・-3と別々に確かめると分かりやすくなります。

items[99:100]ではエラーが出ません。

コロンのある書き方は、範囲を切り出すスライスです。この3個のリストなら空のリスト[]になります。items[99]で1個を取り出す操作とはルールが違います。スライスに変えるだけで直そうとせず、1個の値とリストのどちらが必要かを考えましょう。

ValueErrorやTypeErrorとは何が違いますか?

起きたこと 主なエラー 確かめる点
items[3](3個のリスト) IndexError その番号の場所はあるか
items.remove("ロープ")(ロープがない) ValueError その値が含まれているか
items["1"] TypeError 番号が整数でなく文字列になっていないか

items.index("ロープ")も、値が見つからなければValueErrorです。関数名のindexと、エラー名のIndexErrorを混同しないようにしましょう。inputで受け取った文字を番号にしたいときはinputとintの教材で練習できます。

改造:道具が増えても選べるメニューへ

  1. 実験3の持ち物に「ランタン」を追加し、choiceを4にする。
  2. 今度は1個のリストにし、choiceが1と2のときを比べる。
  3. 空のリストでも案内が表示されるか確かめる。

個数が変わっても、len(items)でその時点の個数を調べられます。言葉にする:「何個あるリストの、何番を取り出したか」を説明してみましょう。

次は、持ち物のルールを作ろう

リスト教材の持ち物上限チャレンジでは、道具を追加できる条件を作ります。リストを作品に使うならおみくじへ。

学習ガイドへ戻る / コードをVS Codeで保存する準備

仕様の確認:Python公式:シーケンスの操作 / Python公式:IndexError