Python 代码中 "list index out of range" 错误：如何避免索引越界？

"list index out of range" 错误通常是由于尝试访问列表中不存在的索引位置导致的，核心解决方案是确保索引在有效范围内，并通过保存列表到变量、检查列表长度、使用安全访问方法等方式避免越界。

• 根本原因：当代码尝试访问列表的某个索引时，该索引值大于或等于列表长度（如列表有2个元素，但尝试访问索引2），或列表为空时访问任何索引。
• 典型场景：

  多次调用 readlines() 导致返回空列表：如示例中，第一次调用 f1.readlines()[0] 后，再次调用时文件指针已到末尾，返回空列表，访问索引0越界。

  硬编码索引未考虑列表长度变化：如固定访问 list[3]，但列表可能只有2个元素。

  循环中未动态检查索引：如 for i in range(5): print(list[i])，但列表长度不足5。

1. 将列表保存到变量：

   避免重复调用 readlines() 或类似方法，防止因状态变化（如文件指针移动）导致返回空列表。

   示例：with open('list_of_info', mode='r+', encoding='utf-8') as f1: lines = f1.readlines() # 保存到变量 print(lines[0], type(lines[0])) # 安全访问

2. 检查列表长度后再访问：

   使用 len(list) 获取列表长度，确保索引在 [0, len(list)-1] 范围内。

   示例：my_list = [1, 2, 3]index = 2if index < len(my_list): print(my_list[index])else: print("索引越界")

3. 使用循环或枚举安全遍历：

   避免硬编码索引，改用 for 循环或 enumerate。

   示例：my_list = ['a', 'b', 'c']for i, item in enumerate(my_list): print(f"索引 {i}: {item}")

4. 使用异常处理捕获错误：

   通过 try-except 捕获 IndexError，避免程序崩溃。

   示例：my_list = [10, 20]try: print(my_list[3])except IndexError: print("访问的索引不存在")

5. 使用安全访问方法（如 get() 类似逻辑）：

   虽然列表无内置 get() 方法，但可自定义函数或使用第三方库（如 pydantic）实现安全访问。

   自定义函数示例：def safe_get(lst, index, default=None): return lst[index] if index < len(lst) else defaultmy_list = [1, 2]print(safe_get(my_list, 1)) # 输出 2print(safe_get(my_list, 5, "默认值")) # 输出 "默认值"

• 场景1：文件读取后重复调用 readlines()。

  错误代码：with open('file.txt') as f: print(f.readlines()[0]) # 第一次调用 print(type(f.readlines()[0])) # 第二次调用可能返回空列表

  修复后：with open('file.txt') as f: lines = f.readlines() print(lines[0], type(lines[0]))

• 场景2：硬编码索引访问动态列表。

  错误代码：data = [1, 2]print(data[3]) # 越界

  修复后：data = [1, 2]if len(data) > 3: print(data[3])else: print("列表长度不足")

• 核心原则：始终确保索引在 0 ≤ index < len(list) 范围内。
• 推荐实践：

  优先将列表保存到变量，避免重复生成。

  访问前检查长度或使用异常处理。

  遍历时使用循环而非硬编码索引。

通过以上方法，可有效避免 "list index out of range" 错误，提升代码健壮性。