在Python中，我们可以通过重载__mul__方法让自定义类支持乘法运算符*的操作，当需要实现链式乘法时，核心要保证__mul__方法的返回值类型和逻辑符合连续调用的要求。
__mul__运算符重载的基本规则
__mul__是Python类的特殊方法，当实例对象参与*运算时会被自动调用，方法接收两个参数：第一个是调用乘法的实例自身self，第二个是参与运算的另一个对象other。要实现链式乘法，必须保证__mul__的返回值是当前类的实例，这样后续的*运算才能继续调用当前类的__mul__方法。
基础实现示例
我们定义一个表示数值向量的类，支持向量和标量的乘法，同时支持链式乘法：
class Vector:
def __init__(self, values):
# 初始化向量的数值列表
self.values = values
def __mul__(self, other):
# 校验other是否为数值类型
if not isinstance(other, (int, float)):
raise TypeError("向量只能和数值类型做乘法")
# 计算新的向量数值
new_values = [v * other for v in self.values]
# 返回当前类的实例，支持链式调用
return Vector(new_values)
def __repr__(self):
# 方便打印查看结果
return f"Vector({self.values})"
# 测试链式乘法
v = Vector([1, 2, 3])
result = v * 2 * 3 * 0.5
print(result) # 输出 Vector([3, 6, 9])
链式乘法的关键注意点
1. 返回值必须是当前类的实例
如果__mul__返回的是其他类型，比如返回列表或者普通数值，后续的*运算就无法调用当前类的__mul__方法，会导致链式调用失败。比如下面的错误示例：
class ErrorVector:
def __init__(self, values):
self.values = values
def __mul__(self, other):
# 错误：返回的是列表，不是当前类的实例
return [v * other for v in self.values]
v = ErrorVector([1,2,3])
# 这里第一次乘法返回列表，列表没有__mul__实现向量乘法，会报错
v * 2 * 3
2. 处理反向乘法__rmul__
当乘法的左操作数不是当前类的实例时，会调用__rmul__方法，比如2 * v的场景，如果需要支持这种写法，需要同时实现__rmul__方法，通常可以直接返回__mul__的结果：
class Vector:
def __init__(self, values):
self.values = values
def __mul__(self, other):
if not isinstance(other, (int, float)):
raise TypeError("向量只能和数值类型做乘法")
new_values = [v * other for v in self.values]
return Vector(new_values)
def __rmul__(self, other):
# 反向乘法直接复用__mul__的逻辑
return self.__mul__(other)
def __repr__(self):
return f"Vector({self.values})"
# 测试反向乘法和链式调用
v = Vector([1,2,3])
result = 2 * v * 3
print(result) # 输出 Vector([6, 12, 18])
3. 类型校验和异常处理
在__mul__方法中需要做好参与运算的other的类型校验，避免不支持的类型参与运算导致逻辑错误。如果支持和其他自定义类的实例做乘法，还需要处理对应的类型判断和运算逻辑，保证返回值的类型符合链式调用的要求。
复杂场景的链式乘法实现
如果类需要支持和其他同类型实例的乘法，同时支持链式调用，需要在__mul__中增加对应的类型判断逻辑：
class Matrix:
def __init__(self, data):
# data是二维列表表示的矩阵
self.data = data
def __mul__(self, other):
if isinstance(other, Matrix):
# 矩阵乘矩阵的逻辑，这里简化为对应位置相乘，实际矩阵乘法需要按规则计算
if len(self.data) != len(other.data) or len(self.data[0]) != len(other.data[0]):
raise ValueError("矩阵维度不匹配")
new_data = [
[self.data[i][j] * other.data[i][j] for j in range(len(self.data[0]))]
for i in range(len(self.data))
]
return Matrix(new_data)
elif isinstance(other, (int, float)):
# 矩阵乘标量的逻辑
new_data = [
[v * other for v in row] for row in self.data
]
return Matrix(new_data)
else:
raise TypeError("矩阵只能和矩阵或数值类型做乘法")
def __repr__(self):
return f"Matrix({self.data})"
# 测试矩阵链式乘法
m1 = Matrix([[1,2],[3,4]])
m2 = Matrix([[2,3],[4,5]])
result = m1 * 2 * m2 * 0.5
print(result) # 输出 Matrix([[1.0, 3.0], [6.0, 10.0]])
常见问题解答
- 为什么链式乘法会报AttributeError错误？通常是
__mul__返回的不是当前类的实例，导致后续调用找不到__mul__方法。 - 链式乘法中不同类型参与运算怎么处理？在
__mul__中增加类型判断分支，分别处理不同场景的运算逻辑，保证返回值都是当前类的实例。 - 需要实现除法等其他运算符的链式调用吗？逻辑和
__mul__一致，只要保证对应运算符重载方法的返回值是当前类的实例即可。
Python__mul__运算符重载链式乘法类运算符重载修改时间：2026-06-26 07:27:28