結論

IndexError: list index out of range は「リストに無い番号の要素を取り出そうとした」ときのエラーです。要素が3個なら使える番号は 0〜2(後ろからは -1〜-3)だけで、3 を指定すると止まります。直し方は、エラーの行で len(リスト) と番号を表示して、どちらが想定と違うかを見ることから始まります。

この記事でわかること

  • このエラーになる原因10種と、原因ごとの再現コード・エラー原文・直したあとの出力
  • トレースバックの ~ と ^ で「どの番号が範囲外か」を読む方法
  • tuple・str・pop・numpy・pandas(iloc)で出る似たエラーとの違いと判断表

2026年11月5日更新|Python 3.13.18・3.12.3・3.11.18、NumPy 2.5.3・pandas 3.0.5 で実行確認

この記事で実際に動かしたもの:エラーを出すコード27本と直したコードを Python 3.13 で実行し、同じコードを 3.12・3.11・IPython 9.18.1・pdb でも動かして表示を比べました。

flowchart TD
    E[list index out of range] --> L[len と番号を表示]
    L --> Z{len が 0?}
    Z -->|はい| EMPTY[空のリスト<br>取得元を調べる]
    Z -->|いいえ| B{番号 ≥ len?}
    B -->|はい| LOOP[範囲・i+1<br>削除を見直す]
    B -->|いいえ| N[マイナスの番号<br>別のリスト]

やりたいことごとに、いちばん早い方法を先にまとめます。

やりたいこと いちばん早い方法 詳しい節
list index out of range の意味を知りたい 無い番号を指定した。要素がn個なら番号は 0〜n-1 エラーの意味
どの番号が範囲外か知りたい エラーの1行上の ^^^ が指す部分を見る トレースバックの読み方
原因を早く特定したい 直前に print(f"{len(a)=} {i=}") を入れる 原因の一覧
最後の要素を取りたい a[-1](a[len(a)] は範囲外) 数え間違いと空のリスト
for文で出る range(len(a)) をやめ、for x in a か enumerate for文とrangeのずれ
CSV・split で出る len(row) で列数を確かめて足りない行を飛ばす split・CSVの列不足
エラーにせず既定値を返したい a[i] if -len(a) <= i < len(a) else None エラーで止めずに既定値を返す
pandas の iloc で出る len(df) と df.empty を確かめる 似たエラーとの違い

確認環境:Ubuntu 24.04.5 LTS の上で、Python 3.13.18 を主に使い、エラーを出すコード(空のリスト・range(len()) の1つずれ・i+1・ループ中の削除・split・CSV・2次元リスト・sys.argv・while・マイナスの番号・re.findall の空の結果など)を1本ずつ実行してトレースバックの原文を取り、直したコードの出力も同じ環境で取りました。トレースバックの印の違いは、同じコードを Python 3.12.3・3.11.18 で実行し、印の無い表示は -X no_debug_ranges で再現しています。似たエラーは tuple・str・range・deque・bytes・NumPy 2.5.3・pandas 3.0.5 で実際に出し、Jupyter と同じ表示は IPython 9.18.1(作業用の仮想環境に導入)、事後デバッグは標準の pdb で確かめました。try と if の速さは timeit で100万回×5回を測った最小値です。IndexError の定義は Python 公式ドキュメント(組み込み例外)、トレースバックの印は「What's New In Python 3.11」(PEP 657)、iloc の挙動は pandas 公式ドキュメントで確かめました。Windows・Mac では実行していませんが、このエラーの文言と原因は OS に依存しない Python 本体の動作です。図は mermaid 11.16.0 で描画を確かめています(確認日 2026年11月5日)。

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「list index out of rangeの原因と直し方|Python再現10例」

IndexError: list index out of rangeの意味(エラー文の読み方)

この節では、エラー文の日本語訳と、リストで使える番号の範囲が分かります。

「IndexError: list index out of range」を日本語にすると「インデックスエラー:リストの番号が範囲外です」です。 Python 公式ドキュメントは IndexError を次のように説明しています。

Raised when a sequence subscript is out of range.(シーケンスの添字が範囲外のときに送出される)

「シーケンス」はリスト・タプル・文字列のように順番のあるデータ、「添字(インデックス)」は a[2] の 2 のような番号です。手元で、要素が3個のリストに番号3を指定すると次のように止まりました。

names = ["佐藤", "鈴木", "高橋"]
print(names[3])
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c1_basic.py", line 2, in <module>
    print(names[3])
          ~~~~~^^^
IndexError: list index out of range

使える番号の範囲

Python のリストは0から数えます。要素が3個なら、前からは 0・1・2、後ろからは -1・-2・-3 が使えます。names[3] は「4個目」を指すので範囲外です。

要素 前からの番号 後ろからの番号
佐藤 0 -3
鈴木 1 -2
高橋 2 -1
(無い) 3 以上は IndexError -4 以下は IndexError

マイナスの番号でも同じエラーになります。a = [1, 2, 3] で a[-3] は 1 を返し、a[-4] は同じ IndexError: list index out of range で止まりました。

最後の要素の取り方

範囲外a[len(a)]。要素が3個なら a[3] になり、必ず IndexError
→
代わりにa[-1] か a[len(a) - 1]。手元ではどちらも「高橋」を返した

覚え方:最後の番号は「個数 − 1」

スライスは範囲外でもエラーにならない

公式ドキュメントには「スライスの添字は、範囲に収まるよう黙って切り詰められる」と書かれています。手元でも a[1:10] は [2, 3]、a[5:] は []、a[-10:2] は [1, 2] を返し、エラーは出ませんでした。1個だけ取る a[i] はエラー、範囲で取る a[i:j] は空のリストになる、と覚えると混乱しません。スライスの書き方は関連記事「Python for文とrangeの使い方|1始まり・逆順・enumerate早見表」で扱っています。

どの番号が範囲外かを特定する(トレースバックの読み方)

この節では、トレースバックの印から「どの行の、どの番号が範囲外か」を読む方法と、自分で確かめる2つの手順が分かります。

トレースバック(エラーの経路の表示)は下から読みます。 最後の行がエラーの種類と説明、その上がエラーの起きた行、さらに上が呼び出し元です。Python 3.11 以降は、エラーの行の下に ~ と ^ の印が付き、^ の部分が範囲外になった番号を指します。

2次元リストではどちらの番号か分かる

table = [[1, 2, 3], [4, 5, 6]](2行3列)で、行の番号と列の番号をそれぞれ範囲外にしてみました。

    print(table[2][1])
          ~~~~~^^^
IndexError: list index out of range

    print(table[1][3])
          ~~~~~~~~^^^
IndexError: list index out of range

1つ目は ^^^ が [2] の下にあり、行の番号が範囲外です。2つ目は [3] の下にあり、列の番号が範囲外です。文言はどちらも同じなので、印の位置だけが手がかりになります。

Python の版で印が違う

この印は Python 3.11 で入った機能(PEP 657)です。同じ table[2][1] を 3.11.18・3.12.3・3.13.18 で実行すると、印はどれも同じ位置に出ました。-X no_debug_ranges を付けると印が消え、3.10 以前と同じく行だけの表示になります。

$ python3 -X no_debug_ranges c7_2d.py
6
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c7_2d.py", line 4, in <module>
    print(table[2][1])
IndexError: list index out of range

印が無い環境では、同じ行に番号が2つ以上あると、どれが原因か表示だけでは分かりません。次の2つの手順で値を見ます。

1

自分で確かめる①:エラーの行の直前で長さと番号を表示する

f文字列の = を使うと、式と値をまとめて出せます。手元では print(f"{len(nums)=} {i=}") が len(nums)=3 i=3 と表示し、番号が長さと同じ(=1つ多い)と分かりました。

Python 3.8 以降

2

自分で確かめる②:pdb で止まった瞬間の値を見る

ターミナルで python3 -m pdb -c continue ファイル名.py と打つと、エラーの起きた行で止まって入力待ちになります。p i, len(nums) と打つと値が出て、q で終わります。コードを書き換えずに調べられます。

標準ライブラリだけで動く

3

長さが短いのか、番号が大きいのかを決める

長さが0なら「データが入っていない」側(取得・検索・split の結果)を、長さは想定どおりで番号が大きいなら「番号の計算」側(ループの範囲・+1・削除)を調べます。

次の節の原因一覧へ

pdb で実際に止めたときの表示です(前半のトレースバックは省略)。

$ python3 -m pdb -c continue c3_rangelen.py
0 10
1 20
2 30
Uncaught exception. Entering post mortem debugging
Running 'cont' or 'step' will restart the program
> /srv/s4/r17/t286/s/c3_rangelen.py(3)<module>()
-> print(i, nums[i])
(Pdb) p i, len(nums)
(3, 3)
(Pdb) q

list index out of rangeの原因一覧(10種)

この節では、このエラーになる原因の全体像と、どの節で直し方を説明しているかが分かります。

原因は「リストが思ったより短い」か「番号が思ったより大きい」の2系統に分かれます。 手元で再現した10種を、その2系統で並べました。

原因 系統 よく出る場面 直し方の要点
1. 番号を1つ多く数えた(a[len(a)]) 番号が大きい 最後の要素を取るとき a[-1]
2. 空のリストの [0] リストが短い 検索・API・ファイルの結果が0件 if a: で先に確かめる
3. range(len(a) + 1) 番号が大きい for文の範囲 for x in a・enumerate
4. a[i + 1] で隣を見る 番号が大きい 差分・前後の比較 range(len(a) - 1)・pairwise
5. ループ中の削除 リストが短くなる 条件に合う要素を消す 内包表記で新しいリストを作る
6. split() の結果が短い リストが短い ログ・文字列の分解 len(parts) を確かめる
7. CSV の列が足りない行 リストが短い 手で作った CSV・空行 足りない行を飛ばす・DictReader
8. 2次元リストの行と列の取り違え 番号が大きい 表・行列・盤面 len(table) と len(table[0])
9. sys.argv[1] の渡し忘れ リストが短い コマンドラインのスクリプト argparse
10. while の i <= len(a) 番号が大きい 番号を手で増やすループ i < len(a)

リストが短い(len が想定より小さい)

空のリスト・0件の検索結果

split・CSV で列が足りない

引数を渡していない・ループ中に削除した

番号が大きい(i が len 以上)

0から数えることを忘れた

range の +1・i+1・while の <=

行と列の取り違え

原因1・2:番号の数え間違いと空のリスト

この節では、最後の要素の取り方と、空のリストで止まらないようにする書き方が分かります。

原因1:最後の要素を a[len(a)] で取った

要素数と最後の番号は1つずれます。 最後の要素は a[-1] で取るのが短く確実です。手元では names[-1] と names[len(names) - 1] がどちらも「高橋」を返しました。

原因2:空のリストの [0]

検索・API・ファイル読み込み・正規表現の結果が0件のとき、[0] で1件目を取ろうとして止まります。このエラーで一番多い形です。

import re
m = re.findall(r"\d+", "no digits here")
print(m[0])
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c23_re.py", line 3, in <module>
    print(m[0])
          ~^^^
IndexError: list index out of range

空のリストは if で「偽」になるので、取り出す前に確かめます。

results = []
first = results[0] if results else None
print(first)                      # None
print(next(iter(results), None))  # None(イテレーターでも使える)

手元ではどちらも None を返しました。ただし、0件になるはずのない場面で0件なら、既定値で隠さず原因(検索の条件・読み込んだファイル・API の応答)を調べるべきです。 既定値で進めると、後の処理で 'NoneType' object is not subscriptable など別のエラーに形を変えて出ることがあります。

原因3・4:for文とrangeのずれ(range(len())・i+1)

この節では、for文で list index out of range が出る2つの典型と、番号を使わない書き方が分かります。

原因3:range(len(a) + 1)

nums = [10, 20, 30]
for i in range(len(nums) + 1):
    print(i, nums[i])
0 10
1 20
2 30
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c3_rangelen.py", line 3, in <module>
    print(i, nums[i])
             ~~~~^^^
IndexError: list index out of range

3行は正しく出て、4回目(i=3)で止まります。「途中まで動いてから止まる」のは、範囲の終わりが1つ多いときの特徴です。番号が要らなければ for n in nums、番号も要るなら enumerate を使うと、範囲を自分で計算しないので、ずれようがありません。

for i, n in enumerate(nums):
    print(i, n)
0 10
1 20
2 30

enumerate と zip の書き方は関連記事「Python zip・enumerateの使い方|for同時ループのコピペ例集」で扱っています。

原因4:a[i + 1] で隣の要素を見る

前日比のように隣同士を比べるとき、最後の要素で「次」が無くなります。

prices = [100, 120, 90, 150]
for i in range(len(prices)):
    diff = prices[i + 1] - prices[i]
    print(i, diff)
0 20
1 -30
2 60
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c4_iplus1.py", line 3, in <module>
    diff = prices[i + 1] - prices[i]
           ~~~~~~^^^^^^^
IndexError: list index out of range

^^^^^^^ が [i + 1] の下にあり、prices[i] ではなく「次」の番号が範囲外だと分かります。直し方は3通りで、手元ではどれも 20 -30 60 を出しました。

import itertools

for i in range(len(prices) - 1):           # 範囲を1つ減らす
    print(i, prices[i + 1] - prices[i])

for a, b in itertools.pairwise(prices):    # Python 3.10 以降
    print(b - a, end=" ")

print([b - a for a, b in zip(prices, prices[1:])])  # zip とスライス

原因10:while の i <= len(a)

番号を自分で増やす while でも同じずれが起きます。while i <= len(a): と書くと、要素を全部表示したあとに止まりました。条件を i < len(a) にするか、for文に書き換えます。

3
1
4
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c10_while.py", line 4, in <module>
    print(a[i])
          ~^^^
IndexError: list index out of range

原因5:ループ中にリストの要素を削除した

この節では、ループの途中で削除すると番号がずれる理由と、エラーにならないのに結果が間違う落とし穴が分かります。

50点未満を消そうとして、番号のループの中で del すると止まります。

scores = [80, 45, 30, 90, 20]
for i in range(len(scores)):
    if scores[i] < 50:
        del scores[i]

番号と長さを毎回表示すると、何が起きているかが見えます。

i=0 len(scores)=5 scores=[80, 45, 30, 90, 20]
i=1 len(scores)=5 scores=[80, 45, 30, 90, 20]
i=2 len(scores)=4 scores=[80, 30, 90, 20]
i=3 len(scores)=4 scores=[80, 30, 90, 20]
i=4 len(scores)=3 scores=[80, 30, 90]
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c5_trace.py", line 4, in <module>
    if scores[i] < 50:
       ~~~~~~^^^
IndexError: list index out of range

range(len(scores)) は最初の長さ5で作られたまま変わりません。 削除でリストは3個に縮んだのに、i は4まで進むので止まります。さらに、i=1 で45を消したあと30が番号1に詰められ、i=2 では90を見るので、30は一度も調べられていません。

エラーが出ない方が危ない例

番号を使わず for s in scores: scores.remove(s) と書くと、エラーは出ませんが結果が間違います。

scores = [80, 45, 30, 90, 20]
for s in scores:
    if s < 50:
        scores.remove(s)
print(scores)
[80, 30, 90]

30が残りました。IndexError で止まる書き方を「エラーが出ない書き方」に変えただけでは直りません。削除しながら回すのではなく、残す要素だけの新しいリストを作ります。

scores = [80, 45, 30, 90, 20]
print([s for s in scores if s >= 50])   # [80, 90]

scores2 = [80, 45, 30, 90, 20]
for i in range(len(scores2) - 1, -1, -1):  # どうしても削除するなら後ろから
    if scores2[i] < 50:
        del scores2[i]
print(scores2)                            # [80, 90]

後ろから消すと、まだ調べていない前側の番号は変わらないので、ずれません。手元ではどちらも [80, 90] になりました。remove・pop・del の違いは関連記事「Python リスト 削除|remove・pop・del・clearの違いと条件削除」で扱っています。

原因6・7:splitの結果やCSVの列が足りない

この節では、文字列の分割と CSV の読み込みで list index out of range が出る理由と、足りない行の扱い方が分かります。

原因6:split() の結果が想定より短い

「名前,年齢,都市」の3つに分かれる前提で parts[2] を取ると、2つしか無い行や空行で止まります。空の文字列を split すると [''](要素1個)になる点も見落としやすいところです。

lines = ["tanaka,30,tokyo", "suzuki,25", "", "sato,41,osaka"]
for line in lines:
    parts = line.split(",")
    print(parts[0], parts[2])
tanaka tokyo
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c6_split.py", line 4, in <module>
    print(parts[0], parts[2])
                    ~~~~~^^^
IndexError: list index out of range

列数を確かめて、足りない行は理由を表示して飛ばします。

for no, line in enumerate(lines, 1):
    parts = line.split(",")
    if len(parts) < 3:
        print(f"skip line {no}: {parts!r}")
        continue
    print(parts[0], parts[2])
tanaka tokyo
skip line 2: ['suzuki', '25']
skip line 3: ['']
sato osaka

先頭だけ切り出したいなら str.partition も使えます。区切りが無くても必ず3つの値を返すので、IndexError になりません。手元では "suzuki,25".partition(",") が ('suzuki', ',', '25')、空の文字列が ('', '', '') を返しました。

原因7:CSV の列が足りない行

手で作った CSV や Excel から書き出した CSV では、末尾の列が抜けた行が混ざります。次の users.csv の3行目は列が2つです。

name,age,city
tanaka,30,tokyo
suzuki,25
sato,41,osaka
tanaka tokyo
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c8_csv.py", line 6, in <module>
    print(row[0], row[2])
                  ~~~^^^
IndexError: list index out of range

行番号を添えて飛ばすと、データを直す人に場所を伝えられます。csv.DictReader を使うと、足りない列は IndexError ではなく None になります。

import csv
with open("users.csv", encoding="utf-8", newline="") as f:
    reader = csv.reader(f)
    next(reader)  # 見出し行
    for lineno, row in enumerate(reader, 2):
        if len(row) < 3:
            print(f"{lineno}行目の列が足りません: {row}")
            continue
        print(row[0], row[2])
tanaka tokyo
3行目の列が足りません: ['suzuki', '25']
sato osaka
{'name': 'tanaka', 'age': '30', 'city': 'tokyo'}
{'name': 'suzuki', 'age': '25', 'city': None}
{'name': 'sato', 'age': '41', 'city': 'osaka'}

11行目だけ動いてから止まる

split・CSV の失敗は、正しい行を処理したあとに出る。原因は「止まった行」のデータにある。

2空行は要素1個

"".split(",") は ['']。parts[0] は通り、parts[1] 以降で止まる。

3DictReader は None になる

列が足りなくても止まらない。代わりに None のまま後の処理に流れるので、そこで確かめる。

原因8・9:2次元リストとsys.argvで出るIndexError

この節では、行と列を取り違えたときの見分け方と、コマンドライン引数を渡し忘れたときの直し方が分かります。

原因8:2次元リストの行と列の取り違え

table[行][列] の順です。len(table) が行の数、len(table[0]) が列の数です。手元の2行3列では len(table)=2 len(table[0])=3 と表示されました。番号が要らなければ、2重の enumerate で回すと取り違えが起きません。

table = [[1, 2, 3], [4, 5, 6]]
print(f"{len(table)=} {len(table[0])=}")
for r, row in enumerate(table):
    for c, v in enumerate(row):
        print(f"table[{r}][{c}]={v}", end=" ")
len(table)=2 len(table[0])=3
table[0][0]=1 table[0][1]=2 table[0][2]=3 table[1][0]=4 table[1][1]=5 table[1][2]=6

行ごとに列の数が違う「ぎざぎざ」のリストでは、len(table[0]) を全部の行に使うと短い行で止まります。行ごとに len(row) を使います。

原因9:sys.argv[1] の渡し忘れ

sys.argv はコマンドライン引数のリストで、[0] はスクリプト名です。引数を付けずに実行すると要素が1個なので、sys.argv[1] で止まります。

$ python3 c9_argv.py
Traceback (most recent call last):
  File "/srv/s4/r17/t286/s/c9_argv.py", line 2, in <module>
    filename = sys.argv[1]
               ~~~~~~~~^^^
IndexError: list index out of range

argparse に任せると、引数が無いときに使い方を表示して終了コード2で終わります。

import argparse
p = argparse.ArgumentParser()
p.add_argument("filename")
args = p.parse_args()
print(args.filename)
$ python3 f_argv.py
usage: f_argv.py [-h] filename
f_argv.py: error: the following arguments are required: filename
$ python3 f_argv.py data.txt
data.txt

VS Code の実行ボタンや Jupyter から動かすと引数が渡らないため、ターミナルでは動くのにエディタからは止まる、ということが起きます。

エラーで止めずに既定値を返す(try・get相当)

この節では、範囲外のときに既定値を返す3つの書き方と、try と if のどちらを選ぶかの目安が分かります。

リストには辞書の dict.get() にあたるメソッドがありません。 範囲外のときに既定値を返したいなら、条件式か try で書きます。

a = [1, 2, 3]

# 1. 条件式(マイナスの番号も考える)
v = a[i] if -len(a) <= i < len(a) else None

# 2. try / except
def get_at(seq, i, default=None):
    try:
        return seq[i]
    except IndexError:
        return default

print(get_at([1, 2, 3], 5, "なし"), get_at([1, 2, 3], -1))  # なし 3

# 3. 先頭だけならスライス
first = a[:1]  # 空なら [] が返る

手元で、要素3個のリストに対して100万回ずつ呼んだ速さです(5回測った最小値)。

49nstry(範囲内)if の条件式は 86ns
152nstry(範囲外で except に入る)if の条件式は 77ns
約2倍範囲外が多いときの差例外を送出する分の費用

範囲外がまれなら try、よく起きるなら if が速くなります。ただ、差は1回あたり100ナノ秒ほどで、読みやすさで選んで困ることはまずありません。

注意したいのは、try を広く囲むと別の IndexError まで握りつぶすことです。関数全体を try: ... except IndexError: pass で囲むと、原因3〜5のようなバグも黙って通り、結果だけがおかしくなります。try は「欠けていて当然のデータ」を扱う1行だけを囲みます。try・except の書き方は関連記事「Python例外処理 try exceptの書き方|raise fromも実行で確認」で扱っています。

代入の範囲外は append で

空のリストに a[0] = "x" と書くと IndexError: list assignment index out of range になります。リストは番号を指定して伸ばせないためです。末尾に足すなら a.append("x")、先に長さを決めるなら [None] * 3 で作ってから代入します。手元では ['x'] と [None, None, 'z'] になりました。

似たエラーとの違い(tuple・str・numpy・pandasのiloc)

この節では、リスト以外で出る「index out of range」の文言と、pandas で IndexError ではなく KeyError になる場合が分かります。

文言の先頭の語で、どのデータで起きたかが分かります。 手元で1つずつ出した原文です。

出したコード エラー原文 意味
[1,2,3][3] IndexError: list index out of range リストの番号が範囲外
a = []; a[0] = "x" IndexError: list assignment index out of range 代入先の番号が範囲外
[].pop() IndexError: pop from empty list 空のリストから取り出した
(1, 2)[2] IndexError: tuple index out of range タプルの番号が範囲外
"abc"[5] IndexError: string index out of range 文字列の位置が範囲外
range(3)[3] IndexError: range object index out of range range の番号が範囲外
deque([1, 2])[2] IndexError: deque index out of range deque の番号が範囲外
b"ab"[2] IndexError: index out of range bytes の番号が範囲外

NumPy:axis と size が文言に入る

NumPy の配列では、どの次元(axis)の何個(size)に対して範囲外かが文言に出ます。

arr = np.array([1, 2, 3]); arr[3]
IndexError: index 3 is out of bounds for axis 0 with size 3

m = np.zeros((2, 3)); m[1, 3]
IndexError: index 3 is out of bounds for axis 1 with size 3

axis 0 は行、axis 1 は列です。arr.shape で各次元の大きさを確かめます。手元では m.shape が (2, 3) でした。

pandas:iloc は IndexError、loc と整数の添字は KeyError

pandas 公式ドキュメントは「iloc は要求された番号が範囲外なら IndexError を送出する。ただしスライスは範囲外を許す」と説明しています。手元の pandas 3.0.5 では次のようになりました。

出したコード(2行の DataFrame) 最後の行のエラー 直し方
df.iloc[5] IndexError: single positional indexer is out-of-bounds len(df) を確かめる
0件に絞った結果の hit.iloc[0] IndexError: single positional indexer is out-of-bounds if not hit.empty
df.iloc[0, 5](列が範囲外) IndexError: index 5 is out of bounds for axis 0 with size 2 df.shape で列数を見る
df.loc[5] KeyError: 5 loc は番号でなくラベル。df.index を見る
index が 100,200,300 の Series の s[0] KeyError: 0 位置なら s.iloc[0]

df.iloc[0, 5] は列の番号が範囲外なのに「axis 0 with size 2」と出ました。 pandas の内部で列の一覧(この例では2列)を引いたときのエラーがそのまま出るためで、トレースバックの最後の行だけを見ると行と列を取り違えます。iloc の行に呼び出し元の自分のコードがあるので、そこで df.shape を確かめます。0件のときの取り方は次のとおりで、手元では None と空の表を返しました。

hit = df[df["age"] > 50]
row = hit.iloc[0] if not hit.empty else None  # None
print(hit.head(1))                            # 空の DataFrame(エラーにならない)
print(df.iloc[-1].to_dict())                  # {'name': 'b', 'age': 30}

KeyError の原因と直し方は関連記事「Python KeyErrorの原因と直し方|dictとpandas」で扱っています。Java で同じ種類のエラーにあたる ArrayIndexOutOfBoundsException は関連記事「Java ArrayIndexOutOfBoundsException原因と対処」で扱っています。

  1. 1最後の行の先頭の語を見るlist・tuple・string・pop・index 3 is out of bounds・single positional indexer
  2. 2自分のコードの行まで上にたどるpandas・NumPy の内部の行ではなく、自分のファイル名の行
  3. 3^ の印で番号を特定するPython 3.11 以降。2つ以上の番号があるときに効く
  4. 4長さと番号を表示して系統を決めるlen が0か小さい → データ側、番号が大きい → 計算側

環境別の見え方(Python 3.10以前・3.11以降・Jupyter・VS Code)

この節では、実行する環境によってエラーの表示がどう違うかと、どこを見ればよいかが分かります。

このエラーの文言と原因は、Windows・Mac・Linux で同じです。 違うのは表示の形で、Python の版と、ターミナル・Jupyter のどちらで動かすかで変わります。使っている版はターミナルで python3 --version(Windows の公式インストーラーで入れた場合は py --version)と打つと分かり、3.11 以上なら ^ の印が出ます。手元の 3.11.18・3.12.3・3.13.18 では、2次元リストと i+1 の例で印の位置が同じでした。

環境 表示の特徴 見る場所
Python 3.11 以降のターミナル エラーの行の下に ~ と ^ ^ の下の番号
Python 3.10 以前のターミナル 行だけで印が無い(-X no_debug_ranges で再現) print か pdb で値を見る
Jupyter・IPython ----> の矢印が行を指し、Cell In[番号] と出る 矢印の行と前後の行
VS Code のデバッグ実行 例外で止まり、変数の値を画面で見られる(公式ドキュメントの範囲) 変数の一覧で len と番号
pandas・NumPy の中で起きた ライブラリ内部の行が下に何段も続く 自分のファイル名の行

IPython 9.18.1 で names[3] を実行したときの表示です。Jupyter Notebook も同じ IPython が表示を作ります。

---------------------------------------------------------------------------
IndexError                                Traceback (most recent call last)
Cell In[1], line 2
      1 names=["a","b","c"]
----> 2 names[3]

IndexError: list index out of range

Jupyter では、前のセルで変数の中身が変わったまま、後のセルを何度も実行して範囲外になることがあります。「さっきまで動いていた」なら、カーネルを再起動して上から順に実行し直すと、どのセルで長さが変わったかが分かります。

よくあるエラー/つまずき

この節では、list index out of range の周辺でつまずきやすい点を、症状・原因・直し方の表で確かめられます。

症状(原文) 原因 直し方
何行か出力してから IndexError: list index out of range ループの範囲が1つ多い・i+1 enumerate・range(len(a) - 1)
1件目の処理で IndexError: list index out of range 空のリスト if a:。0件の理由を調べる
ファイルの途中の行で止まる その行の列が足りない・空行 len(row) を確かめて行番号を表示
エラーは出ないが要素が残る for で回しながら remove した 内包表記で新しいリストを作る
IndexError: list assignment index out of range 空のリストに番号で代入した append・[None] * n
IndexError: pop from empty list 空のリストから pop した if stack: で確かめる
ターミナルでは動くがエディタで止まる sys.argv[1] に引数が渡っていない argparse・実行時の引数の設定
KeyError: 0(pandas の Series) 位置のつもりで s[0] と書いた s.iloc[0]
try を足したら別の結果がおかしくなった except IndexError が別のバグも隠した try は1行だけ囲む

0件・1件・複数件の3通りで試す

このエラーは、データの件数が境界にあるときに出ます。原因4の「隣同士の差」を、番号で書いた版と zip で書いた版に分け、件数を変えて実行しました。

def diffs(prices):                  # zip で書いた版
    return [b - a for a, b in zip(prices, prices[1:])]

def diffs_bad(prices):              # 番号で書いた版
    return [prices[i + 1] - prices[i] for i in range(len(prices))]

for case in ([], [100], [100, 120]):
    try:
        print(case, diffs(case), diffs_bad(case))
    except IndexError as e:
        print(case, "IndexError:", e)
入力 zip で書いた版 番号で書いた版
[](0件) [] [](エラーにならない)
[100](1件) [] IndexError: list index out of range
[100, 120](2件) [20] IndexError: list index out of range

0件では番号の版もエラーになりませんでした。 range(0) は1回も回らないためです。「空のリストで試したから安心」とはならず、1件のときに初めて止まります。0件・1件・複数件の3通りを試すと、この種の誤りは本番のデータを流す前に見つかります。

  • 1番号で回す前に、要素で回せないか考えたかfor x in a・enumerate・zip・pairwise で多くの場合は番号の計算が要らない
  • 2外から来たデータの長さを確かめたか検索結果・API・CSV・split・引数は、0件や列不足を前提に書く
  • 3ループの中でリストを変えていないか削除・追加をするなら新しいリストを作るか、後ろから回す
  • 4try の範囲が1行に絞られているか広く囲むと原因3〜5のバグも黙って通る
  • 5境界のテストを書いたか0件・1件・最後の1件の3通りを試すと、このエラーの多くは事前に見つかる

判断表:list index out of rangeの直し方の選び方

この節では、場面ごとにどの直し方を選ぶかが一覧で分かります。

場面 選ぶ直し方 選ばない方がよいもの
全要素を順に処理する for x in a・enumerate(a) range(len(a)) で番号を計算
隣同士を比べる itertools.pairwise・zip(a, a[1:]) 最後で範囲外になる a[i + 1]
条件に合う要素を消す 内包表記で残す要素を集める for の中で remove・del
0件がありうる結果の1件目 a[0] if a else None 関数全体を try で囲む
0件のはずがない結果の1件目 そのまま a[0](止まって気づける) 既定値で隠す
列数がそろわない CSV len(row) で飛ばして行番号を記録・DictReader エラーを無視して続ける
コマンドライン引数 argparse sys.argv[1] を直接読む
pandas で行を位置で取る df.iloc と df.empty 位置のつもりの df.loc[0]・s[0]

大事なのは、エラーを消すことより「なぜ長さが足りないのか」を説明できるようにすることです。データが欠けるのが正常なら既定値で進め、欠けるはずがないなら止まったままにして原因を直します。

よくある質問

この節では、list index out of range について検索されることの多い疑問に答えます。

Q. list index out of range の日本語の意味は?

A. 「リストの番号(インデックス)が範囲外です」という意味です。IndexError は「番号の誤り」を表す例外の名前です。

Q. 要素が3個なのに a[3] がエラーになるのはなぜ?

A. Python は0から数えるので、3個のリストの番号は 0・1・2 です。a[3] は4個目を指します。

Q. マイナスの番号でもこのエラーになる?

A. なります。3個のリストで a[-3] は通り、a[-4] は同じ IndexError: list index out of range になりました。

Q. スライスで範囲外を指定してもエラーにならないのはなぜ?

A. 公式ドキュメントに「スライスの添字は範囲内に黙って切り詰められる」とあるとおりの仕様です。a[1:10] は [2, 3]、a[5:] は空のリストを返しました。

Q. try-except で囲めば解決?

A. データが欠けるのが正常な1行だけなら有効です。広く囲むと、ループの範囲やループ中の削除など本来直すべきバグも隠れ、結果だけがおかしくなります。

Q. リストに dict.get のようなメソッドは無い?

A. ありません。a[i] if -len(a) <= i < len(a) else None の条件式か、小さな関数で try を書きます。

Q. ループの最後だけエラーになるのはなぜ?

A. 範囲の終わりが1つ多い(range(len(a) + 1)・a[i + 1]・while i <= len(a))ときの特徴です。途中までは正しく動くので気づきにくくなります。

Q. list assignment index out of range との違いは?

A. 読み出しではなく代入で範囲外になったときの文言です。リストは番号で伸ばせないので、append を使うか、先に長さを決めて作ります。

Q. pandas で IndexError ではなく KeyError が出るのはなぜ?

A. loc や Series の [] は「位置」ではなく「ラベル(index の値)」で探すためです。位置で取るなら iloc を使います。

Q. Python 3.10 以前で、どの番号が範囲外か知るには?

A. 3.10 以前には ^ の印がありません。エラーの行の直前で print(f"{len(a)=} {i=}") を入れるか、python3 -m pdb で止めて値を表示します。

Q. IndexError と KeyError は同じ仲間?

A. 公式ドキュメントでは、どちらも LookupError を親に持つ例外です。except LookupError で両方を受け取れますが、原因の種類が分からなくなるので、分けて書く方が調べやすくなります。

まとめ

この節では、記事の要点を5つに絞って振り返ります。

  • 意味:リストに無い番号を指定した。要素がn個なら番号は 0〜n-1(後ろからは -1〜-n)。
  • 特定:Python 3.11 以降は ^ の印が範囲外の番号を指す。印が無ければ len と番号を表示するか pdb で止める。
  • 原因:「リストが短い」(空・split・CSV・引数・削除)か「番号が大きい」(数え間違い・+1・while の <=・行と列)の2系統。
  • 直し方:番号を計算せず for x in a・enumerate・pairwise・内包表記を使い、外から来たデータは長さを確かめる。
  • 注意:try で広く囲むとバグも隠れる。pandas の loc は KeyError、iloc は IndexError と覚えておく。

参考・出典

この節では、この記事で確かめた公式の資料が分かります(確認日 2026年11月5日)。

  • Python 公式ドキュメント「Built-in Exceptions」IndexError・LookupError・KeyError:https://docs.python.org/3/library/exceptions.html
  • Python 公式ドキュメント「What's New In Python 3.11」PEP 657:https://docs.python.org/3/whatsnew/3.11.html
  • Python 公式ドキュメント「itertools.pairwise」:https://docs.python.org/3/library/itertools.html
  • Python 公式ドキュメント「csv」「argparse」「pdb」:https://docs.python.org/3/library/csv.html ・ https://docs.python.org/3/library/argparse.html ・ https://docs.python.org/3/library/pdb.html
  • pandas 公式ドキュメント「pandas.DataFrame.iloc」:https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.iloc.html
  • NumPy 公式ドキュメント「Indexing on ndarrays」:https://numpy.org/doc/stable/user/basics.indexing.html

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「list index out of rangeの原因と直し方|Python再現10例」

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。

WE ARE HIRING

RJCで一緒に開発しながら、
成長を楽しみませんか?

RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!

  • 127日年間休日
  • 12時間平均残業時間
  • 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!

ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり