python文档中对特殊方法（如`__len__`、`__getitem__`）使用`object.`前缀，并非指这些方法是`object`基类的属性，也不是要求将它们添加到`object`类。这是一种文档约定，旨在表明这些是用户定义的任意类可以实现的方法，以模拟内置类型行为，从而融入python的数据模型。`object`基类本身通常不实现这些特殊方法。
理解Python的特殊方法（Dunder Methods）
在Python中，特殊方法（Special Methods），也常被称为“魔术方法”或“双下划线方法”（Dunder Methods），是名称前后各有两个下划线的方法（例如__init__、__len__、__getitem__）。它们是Python数据模型的核心组成部分，允许用户定义的类与内置函数或操作符（如len()、+、[]）进行交互，从而实现类似内置类型的行为。通过实现这些方法，我们可以使自定义对象支持切片、迭代、上下文管理等高级功能。
例如，当我们对一个对象调用len(my_object)时，Python会在my_object的类中查找并调用__len__方法。同样，当使用my_object[key]进行索引或切片时，Python会调用__getitem__方法。
object.前缀的含义解析
许多开发者在阅读Python官方文档时，可能会遇到类似object.__len__(self)或object.__getitem__(self, key)这样的描述，从而产生疑问：这里的object是否特指Python的顶级基类object？难道这些方法是object类的属性吗？
答案是否定的。文档中的object.前缀并非指代Python的内置object基类。它的真正含义是一种文档约定，用于指示：
立即学习“Python免费学习笔记（深入）”；
- 可实现的方法：这些方法是任意用户定义的类都可以（也应该）实现的方法，以使其对象能够响应特定的内置操作或函数。
- 通用接口：它代表了一个通用的接口或契约，任何遵循此契约的类都可以通过实现相应的方法来融入Python的数据模型。
换句话说，object.在这里可以被理解为一个占位符，它代表“任何你正在定义的、希望实现特定行为的类”。
为什么不是object基类？
理解这一点的关键在于，object基类本身并没有实现所有这些特殊方法。例如，object类没有__len__方法，尝试对一个纯粹的object实例调用len()会引发TypeError：
obj = object() # len(obj) # 这会引发 TypeError: object of type 'object' has no len()
同样，object类也没有__getitem__方法。如果object基类本身实现了这些方法，那么所有继承自object的类（几乎所有Python类都如此）都将自动拥有这些行为，这显然不符合Python的设计哲学，因为并非所有对象都应该具有长度或支持索引。
因此，文档使用object.前缀是为了强调这些是可供实现的钩子（hooks），而不是object类已经提供的功能。
实际应用示例
当你需要创建一个模拟列表或字典行为的自定义类时，你会在自己的类中实现__len__和__getitem__等方法，而不是尝试修改或继承object类并添加这些方法。
以下是一个简单的示例，演示如何在一个自定义类中实现__len__和__getitem__来模拟容器类型：
class MyContainer:
"""
一个自定义容器类，模拟列表的部分行为。
"""
def __init__(self, data):
if not isinstance(data, list):
raise TypeError("MyContainer expects a list for initialization.")
self._data = data
def __len__(self):
"""
实现 len() 内置函数的功能。
返回容器中元素的数量。
"""
print("__len__ called")
return len(self._data)
def __getitem__(self, key):
"""
实现 self[key] 的索引和切片功能。
"""
print(f"__getitem__ called with key: {key}")
# 这里直接委托给内部列表的 __getitem__
return self._data[key]
def __repr__(self):
return f"MyContainer({self._data!r})"
# 创建 MyContainer 实例
my_list_like_obj = MyContainer([10, 20, 30, 40, 50])
# 使用 len()
print(f"Length of my_list_like_obj: {len(my_list_like_obj)}")
# 使用索引
print(f"Element at index 2: {my_list_like_obj[2]}")
# 使用切片
print(f"Slice from index 1 to 4: {my_list_like_obj[1:4]}")
# 尝试访问不存在的索引会引发 IndexError
try:
print(my_list_like_obj[10])
except IndexError as e:
print(f"Caught expected error: {e}")代码解析：
- MyContainer类继承自object（在Python 3中是隐式继承）。
- 我们在MyContainer类中定义了__len__和__getitem__方法，而不是在object类中。
- 当对my_list_like_obj调用len()或使用[]操作符时，Python会自动找到并执行MyContainer类中对应的特殊方法。
总结
Python文档中object.__method_name__的写法是一个重要的约定，它明确指示了这些是用户定义的类可以实现的方法，以使其对象能够融入Python的内置行为和数据模型。它并非指object基类本身实现了这些方法，也不是要求开发者将这些方法添加到object类。理解这一约定对于正确设计和实现Python中的自定义类型至关重要。
