list.index() 找不到元素时抛 ValueError 而非返回 -1 或 None；支持 start/stop 参数限定搜索范围但返回原列表绝对索引；仅返回首个匹配索引，查全部需用 enumerate；行为与 str.find() 不同，不可混用。
list.index() 找不到元素时会抛出 ValueError
直接调用 list.index() 查找不存在的元素，Python 不会返回 -1 或 None，而是立即报错：ValueError: 'x' is not in list。这是最常踩的坑——尤其在写条件逻辑或循环中没加异常处理时，程序直接中断。
正确做法是显式捕获异常，或者先用 in 判断再查索引：
- 用
try/except：适合“大概率存在、失败属异常”的场景 - 用
if x in my_list: idx = my_list.index(x)：适合“存在性不确定、且不希望中断流程”的情况；但注意这做了两次遍历（in一次，index()又一次），对大列表有轻微性能损失
list.index() 支持 start 和 stop 参数控制搜索范围
list.index() 不只支持单参数形式，还能指定起始和结束位置，类似切片语法：my_list.index(x, start, stop)。它只在 [start:stop] 范围内查找，且返回的是**原列表中的绝对索引**，不是子范围内的相对位置。
常见误用是以为 start=2 就从第 2 个元素开始“重新编号”，其实返回值仍是原列表下标：
立即学习“Python免费学习笔记（深入）”；
nums = [10, 20, 30, 40, 30] print(nums.index(30, 2)) # 输出 2，不是 0 print(nums.index(30, 3)) # 输出 4，不是 1
-
start和stop都是可选参数，stop默认为len(list) - 如果
start >= len(list)，直接抛ValueError，哪怕元素实际在后面 - 该特性适合跳过前缀、或分段查找重复元素（如找第二次出现的位置）
查找所有匹配索引不能只靠 list.index()
list.index() 永远只返回第一个匹配项的索引。想获取全部位置，必须手动遍历。没有内置“批量索引”方法，强行用多次 index() + start 参数虽然可行，但代码冗长且易错。
推荐用列表推导式配合 enumerate()：
text = ['a', 'b', 'a', 'c', 'a'] indices = [i for i, x in enumerate(text) if x == 'a'] # [0, 2, 4]
- 比
range(len(text))更 Pythonic，避免索引越界风险 - 如果列表极大且只需前 N 个匹配，可用生成器表达式 +
itertools.islice控制数量，避免一次性构建完整列表 - 若需频繁做此类查找，考虑提前构建值→索引列表的字典（如
{'a': [0,2,4], 'b': [1]}），空间换时间
字符串的 .find() 和 list.index() 行为不一致
容易混淆的是字符串的 str.find()：找不到时返回 -1，而 list.index() 抛异常。这不是疏忽，是设计哲学差异——列表操作更强调“明确意图”，字符串查找常用于解析，容忍缺失更实用。
- 别试图把
list.index()当成str.find()用，否则上线后突然崩 - 如果业务逻辑确实需要类
find()行为（即“找不到就返回 -1”），建议封装一层：
def safe_index(lst, item, default=-1):
try:
return lst.index(item)
except ValueError:
return default真正麻烦的是嵌套结构或自定义对象——list.index() 依赖 == 判断，若元素是字典、类实例等，得确认其 __eq__ 实现是否符合预期，否则可能“明明看着一样却找不到”。
