Python IndexError: list index out of range の原因と解決方法

IndexError: list index out of range とは

Pythonでリストや文字列などのシーケンスを操作する際、「IndexError: list index out of range」は非常によく遭遇するエラーの一つです。これは、存在しないインデックスにアクセスしようとしたときに発生します。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: インデックスの範囲外アクセス (正のインデックス)

my_list = [10, 20, 30]
# リストのインデックスは 0, 1, 2 まで
# インデックス 3 は範囲外のため IndexError
print(my_list[3])

my_listは3つの要素を持つため、有効なインデックスは0から2までです。インデックス3にアクセスしようとすると、リストの範囲を超えているためIndexErrorが発生します。

my_list = [10, 20, 30]
# 有効なインデックスでアクセス
print(my_list[2]) # 最後の要素 (30) にアクセス
print(my_list[0]) # 最初の要素 (10) にアクセス

パターン2: 空のリストへのアクセス

empty_list = []
# 空のリストには要素がないため、インデックス 0 も範囲外
print(empty_list[0])

empty_listは要素が一つもないため、どのインデックスにアクセスしようとしてもIndexErrorが発生します。リストが空でないことを確認せずに要素にアクセスすると、このエラーが起こりえます。

empty_list = []
# リストが空でないことを確認してからアクセス
if empty_list:
    print(empty_list[0])
else:
    print("リストは空です")

パターン3: ループ処理におけるオフバイワンエラー

data = ['A', 'B', 'C']
# len(data) は 3 だが、range(len(data) + 1) は 0, 1, 2, 3 を生成
# インデックス 3 は範囲外のため IndexError
for i in range(len(data) + 1):
    print(data[i])

len(data)は3ですが、range(len(data) + 1)は0, 1, 2, 3を生成します。インデックス3にアクセスしようとしたときに、リストの有効なインデックスを超えてしまうためIndexErrorが発生します。

data = ['A', 'B', 'C']
# range(len(data)) は 0, 1, 2 を生成し、有効なインデックス範囲内に収まる
for i in range(len(data)):
    print(data[i])

# よりPythonicな方法（IndexErrorを回避）
for item in data:
    print(item)

根本原因の特定方法

エラーが発生した行の直前で、リストの長さ(len())とアクセスしようとしているインデックスの値を確認してください。pdbなどのデバッガを使用すると、ステップ実行で変数の状態を詳細に追跡できます。

my_list = [10, 20, 30]
index = 3 # エラーの原因となるインデックス
print(f"リストの長さ: {len(my_list)}")
print(f"アクセスしようとしているインデックス: {index}")

# この行で IndexError が発生
# print(my_list[index])

防止策とベストプラクティス

リストや文字列にアクセスする前に、len()関数で長さを確認し、インデックスがその範囲内にあることを保証するようにしましょう。ループ処理では、range(len(list))ではなくfor item in list:のように直接要素を反復処理する方が安全です。

my_list = [10, 20, 30]
index = 3

# インデックスが有効範囲内か確認
if 0 <= index < len(my_list):
    print(my_list[index])
else:
    print("インデックスが範囲外です")

# リストが空でないか確認
empty_list = []
if empty_list:
    print(empty_list[0])

よくある質問（FAQ）