使用变量索引列表时出现IndexError: list index out of range错误求助

Hey there! I’ve run into this exact error dozens of times—let’s walk through the most common fixes for when you hit this while using a variable to index a list.

1. Double-check your variable’s value against the list’s length #

Lists use 0-based indexing in most programming languages, meaning a list with n elements only has valid indices from 0 to n-1. If your variable’s value is equal to or larger than the list’s length, you’ll trigger this error right away.

Example of the problem:

fruits = ["apple", "banana", "cherry"]
selected_index = 3  # List has 3 elements, max valid index is 2
print(fruits[selected_index])  # Boom—IndexError!

Quick fix: Add a bounds check before indexing to ensure the variable is valid:

fruits = ["apple", "banana", "cherry"]
selected_index = 3

if 0 <= selected_index < len(fruits):
    print(fruits[selected_index])
else:
    print(f"Oops! Index {selected_index} is invalid. This list only has {len(fruits)} elements.")

2. Verify your list isn’t empty or missing elements #

Sometimes the issue isn’t the variable—it’s that your list has fewer elements than you expected (or is completely empty). For example:

user_inputs = []  # Accidentally emptied the list earlier in your code
target_index = 0
print(user_inputs[target_index])  # Empty lists have no valid indices at all

Fix: Check if the list is non-empty first, then validate the index:

user_inputs = []
target_index = 0

if user_inputs and 0 <= target_index < len(user_inputs):
    print(user_inputs[target_index])
else:
    print("Either the list is empty, or your index is out of range!")

3. Audit how your variable is being calculated #

If your index variable comes from a loop, calculation, or user input, there might be a bug in how it’s generated. For example, a loop that runs one too many times:

numbers = [1, 2, 3]
# range(len(numbers)+1) makes i go 0,1,2,3—way beyond the list's max index
for i in range(len(numbers)+1):
    print(numbers[i])

Fix: Trace through how your variable gets its value. In the loop example, just use range(len(numbers)) to limit i to valid indices.

内容的提问来源于stack exchange，提问作者Gadzz