如何通过Python的__getitem__让类对象支持索引访问？-Python教程-PHP中文网

__getitem__ 方法使实例支持方括号访问，传入索引或键即触发；需按类型（int/slice/其他）分支处理，正确抛出 indexerror/keyerror，并与 __len__ 和迭代协议保持一致。

如何通过python的__getitem__让类对象支持索引访问？

getitem 的基本写法和触发条件

只要类定义了 __getitem__ 方法，实例就能用方括号语法（如 obj[0]、obj['key']）访问——Python 会自动把索引或键传给这个方法。它不依赖继承、也不需要实现其他协议，纯靠方法名触发。

常见错误是误以为必须返回列表或支持切片；其实只要方法能处理传入的 key 参数并返回合理值即可。比如字符串索引传的是 int，字典式访问传的是 str 或任意 hashable 类型。

参数名不限于 key，但语义上建议用 key 或 index
若传入非法索引（如越界整数），应主动抛出 IndexError 或 KeyError，否则可能静默失败
支持切片的关键是判断 key 是否为 slice 类型：用 isinstance(key, slice) 分支处理

处理 int 索引与 slice 索引的差异

当用户写 obj[2] 或 obj[1:4] 时，key 分别是 int 和 slice 对象。不区分会导致切片报错或返回意外结果。

典型写法是先检查类型再分支处理：

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

def __getitem__(self, key):
    if isinstance(key, int):
        if key = len(self._data):
            raise IndexError("index out of range")
        return self._data[key]
    elif isinstance(key, slice):
        return self._data[key]
    else:
        raise TypeError(f"unsupported key type: {type(key).__name__}")