直接实现 __getitem__ 即可支持切片,因 Python 将 obj[1:5] 转为传入 slice(1, 5, None);需显式处理 slice 类型,用 key.indices(len(self._data)) 归一化并返回同类型实例。

为什么直接实现 __getitem__ 就能支持切片
Python 的切片不是靠单独的魔法方法触发的,而是统一走 __getitem__。当你写 obj[1:5] 时,解释器会传入一个 slice 对象(如 slice(1, 5, None))作为参数,而不是整数。所以只要你在 __getitem__ 里正确处理 slice 类型,切片就自然可用。
常见错误是只处理 int 索引,遇到切片就抛 TypeError: 'slice' object is not subscriptable。别写 if isinstance(key, int): ... else: raise TypeError 这种拦截逻辑。
- 必须显式检查
isinstance(key, slice) -
slice对象有.start、.stop、.step三个属性,可能为None,需用self._data长度做边界归一化 - 返回值应为新容器实例(保持类型一致),而非
list—— 否则链式切片如obj[1:10][2:4]会失败
如何正确归一化 slice 的 start/stop/step
手动计算切片边界容易出错,尤其当 start 或 stop 是负数、或超出范围时。Python 列表内部有一套规则:负索引从末尾算,越界值会被截断,step=None 视为 1。你的类也该复现这套行为,否则用户直觉会失效。
最稳妥的方式是委托给内置 range:用 range(*key.indices(len(self._data))) 获取实际下标序列,再按序取值。它自动处理所有边界和负数逻辑,且性能足够好。
立即学习“Python免费学习笔记(深入)”;
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
- 不要自己写
if key.start 这类逻辑 —— 容易漏 case -
key.indices(n)返回三元组(start, stop, step),专为切片设计 - 若容器不支持随机访问(比如链表),就不能依赖下标,得重写遍历逻辑;但多数场景用
list底层,直接用indices最省心
要不要实现 __len__ 和 __iter__
切片本身不强制要求 __len__ 或 __iter__,但缺它们会导致很多周边功能断裂。比如 len(obj[1:5]) 会失败,for x in obj[1:5] 也会报 TypeError: 'MyList' object is not iterable。
关键点在于:切片返回的是同类型实例,所以它的迭代、长度行为必须和原类一致。如果基类没实现 __iter__,子实例自然也不能迭代。
-
__len__必须实现,否则len()调用直接报错;返回len(list_result)即可 -
__iter__推荐用yield from self._data,简洁且兼容切片后的新实例 - 不实现
__contains__也没关系——Python 默认回退到__iter__做线性查找,够用
切片返回新实例时的构造陷阱
切片结果应该是一个“同类型新对象”,而不是裸 list。但直接写 return MyContainer(result_list) 可能出问题:如果类构造函数有额外参数(比如缓存策略、只读标志),这个调用就会失败或丢失状态。
更健壮的做法是提供一个类方法(如 _from_iterable)或受保护的构造入口,专门用于内部创建轻量实例,绕过复杂初始化逻辑。
- 避免在
__getitem__里硬编码MyContainer(...) - 如果类有不可变语义,切片结果也应继承该语义(例如 tuple 底层就该用
tuple()构造) - 测试
type(obj[1:3]) is type(obj)是否为True,这是用户预期的行为
切片看着简单,真正踩坑的地方都在边界归一化和实例构造上——尤其是当你的容器要支持负步长([::-1])或空切片([10:5])时,range.indices() 是唯一靠谱的防线。

















