直接用+报错是因为Python未定义自定义类的运算符行为，必须显式实现__add__等魔法方法；加减乘除对应__add__、__sub__、__mul__、__truediv__，需返回新对象、处理类型兼容性并正确支持反向运算。

怎样在python中为自定义类实现加减乘除运算符重载

为什么直接用 `+` 会报错：`TypeError: unsupported operand type(s)`

当你对两个自定义类实例写 a + b 却没定义任何特殊方法时，Python 根本不知道怎么算——它不会自动把属性加起来，也不会抛个友好提示，而是直接扔出 TypeError: unsupported operand type(s) for +: 'MyClass' and 'MyClass'。这不是 bug，是 Python 的明确设计：运算符重载必须显式声明。

必须实现哪些魔法方法：从 `add` 到 `truediv`

加减乘除对应的标准双目运算符方法是：

+ → __add__(self, other)（返回新对象，别改 self）
- → __sub__(self, other)
* → __mul__(self, other)
/ → __truediv__(self, other)（注意不是 __div__，那是 Python 2 的）

这些方法都得返回一个值（通常是同类新实例），如果无法处理 other 类型，应返回 NotImplemented（不是 NotImplementedError！），让 Python 尝试反向方法（如 __radd__）或报错。

Python Use Agent

智能执行Python任务，自动生成、执行代码并反馈结果，无需额外配置，兼容旧命令。

下载

容易踩的坑：类型检查、可变性与反向方法

常见错误不是忘了写方法，而是写了但不健壮：

硬编码假设 other 是同类型——实际可能传入 int 或 float，需用 isinstance(other, (int, float)) 或 hasattr(other, 'value') 做兼容
在 __add__ 里直接修改 self.x += other.x——这破坏了不可变习惯，也导致链式运算出错（a + b + c 中 a 被意外改掉）
只实现了 __add__，但用户写了 5 + obj——这时调用的是 int.__add__，它不认识你的类，所以必须补 __radd__(self, other) 并让它等价于 self.__add__(other)
除法返回 int 却没处理 ZeroDivisionError，尤其当 other 是自定义类且其“除数”为 0 时

一个最小可行示例：带数值字段的 `Vector2D`

class Vector2D:
    def __init__(self, x, y):
        self.x = x
        self.y = y
<pre class="brush:php;toolbar:false;">def __add__(self, other):
    if isinstance(other, Vector2D):
        return Vector2D(self.x + other.x, self.y + other.y)
    elif isinstance(other, (int, float)):
        return Vector2D(self.x + other, self.y + other)
    return NotImplemented

def __radd__(self, other):
    return self.__add__(other)  # 支持 3 + v

def __mul__(self, other):
    if isinstance(other, (int, float)):
        return Vector2D(self.x * other, self.y * other)
    return NotImplemented

def __repr__(self):
    return f"Vector2D({self.x}, {self.y})"