IndexError: list index out of range 表示访问了列表中不存在的索引。例如长度为3的列表，合法索引为0到2，若访问索引3则报错。常见于循环边界控制不当、空列表取值、遍历中修改列表等场景。解决方法包括检查列表长度、使用异常处理、避免手动索引循环或利用负索引特性。关键是在访问前确保索引有效，如通过if my_list判断非空后再操作，从而提升代码健壮性。
在使用 Python 编程时，
IndexError: list index out of range
是一个常见错误。它表示你尝试访问列表（或其它序列类型）中不存在的索引位置。理解这个错误的原因和解决方法，能有效提升代码的健壮性。
什么是 IndexError？
当你对一个序列（如列表、元组、字符串）进行索引操作时，Python 要求索引值在合法范围内。例如：
对于长度为
n
的列表，合法索引是
0 到 n-1
（正向）或
-n 到 -1
（负向）。
若访问
list[5]
，但列表只有 3 个元素，就会触发 IndexError。
示例：
立即学习
“
Python免费学习笔记（深入）
”；
常见引发场景
以下几种情况容易导致索引越界：
循环中索引控制不当
：比如用 while 循环手动递增索引，但未正确判断边界。
空列表取值
：对一个空列表执行
my_list[0]
，即使索引为 0 也会报错。
动态修改列表的同时访问索引
：在遍历过程中删除元素，导致后续索引失效。
误将字符串索引用于列表操作
：虽然少见，但在处理用户输入或配置时可能发生。
反例：
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
如何避免和调试
预防比修复更重要。可以采取以下措施：
使用 for 循环遍历元素
：优先用
for item in my_list:
避免显式索引。
访问前检查长度
：
再访问。
使用异常处理
：用 try-except 捕获 IndexError，提供友好提示或默认值。
利用负索引特性
：如获取最后一个元素用
my_list[-1]
，但需确保列表非空。
安全写法示例：
基本上就这些。只要注意索引范围和边界条件，就能大幅减少 IndexError 的发生。关键是养成检查长度或使用安全遍历方式的习惯。
my_list = [10, 20, 30]
print(my_list[3]) # 报错：IndexError: list index out of rangei = 0
while i <= len(my_list):
print(my_list[i]) # 当 i == len(my_list) 时越界
i += 1if len(my_list) > index:if my_list:
print("最后一个元素是:", my_list[-1])
else:
print("列表为空")