Python列表长度校验场景下如何规范编写异常处理逻辑？

原代码问题说明 #

• 直接抛出通用Exception基类，异常粒度太粗，不符合Python开发规范，容易和其他业务异常混淆，后续难以做精准捕获
• 抛出异常时未传入提示信息，导致长度大于1的分支打印e时无有效内容，无法满足报错信息对齐的需求
• 冗余的else分支，逻辑可以更简洁

优化后代码（内置异常版本，通用场景推荐） #

x = []
try:
    if len(x) > 1:
        # 抛出语义匹配的ValueError，提示信息和原生IndexError对齐
        raise ValueError("list index out of range")
    testVar = x[0]
except IndexError as e:
    print(e)
    print("list does not have any elements.")
except ValueError as e:
    print(e)
    print("There are too many elements in the list.")

优化点说明 #

• 用内置ValueError替代通用Exception，ValueError专门用于参数/值不符合预期的场景，语义明确符合规范
• 两个分支的异常类型完全不同（IndexError/ValueError），满足两类异常区分的需求
• 给ValueError传入了和原生IndexError完全一致的提示文本，两种场景都会打印list index out of range，符合需求
• 去掉冗余else分支，代码更简洁易读

自定义异常版本（大型项目/强语义场景推荐） #

如果需要更彻底的异常隔离，避免和其他业务的同类内置异常混淆，可以自定义专属异常类：

# 自定义两类专属异常，继承自内置异常类，兼容原有捕获逻辑
class EmptyListError(IndexError):
    pass

class TooManyElementsError(ValueError):
    pass

x = [1, 2]
try:
    if len(x) == 0:
        raise EmptyListError("list index out of range")
    if len(x) > 1:
        raise TooManyElementsError("list index out of range")
    testVar = x[0]
except EmptyListError as e:
    print(e)
    print("list does not have any elements.")
except TooManyElementsError as e:
    print(e)
    print("There are too many elements in the list.")

内容的提问来源于stack exchange，提问作者Capitán Planeta