__int__ 必须返回 int 实例，不可为 float、str 或 None；对浮点内部值应截断（如 int() 或 math.trunc()），禁用 round()；语义不明确或精度敏感时需抛出 ValueError 或 TypeError；__index__ 用途不同，需单独实现。
为什么 __int__ 返回非 int 类型会报错
调用 int(obj) 时，Python 会严格检查 obj.__int__() 的返回值：必须是 int 实例，不能是 float、str 或子类（哪怕继承自 int）。常见错误是直接返回 round(self.value)（返回 float）或 int(str(self.value))（隐式触发递归）。
-
__int__必须返回int，且不能是None - 若内部值是
float，需显式用int()截断（不是四舍五入），例如int(3.9)→3 - 若逻辑上无法转为整数（如单位不匹配、精度丢失严重），应抛出
ValueError，而非返回近似值
如何处理浮点型内部状态的截断逻辑
很多自定义数值类（如 Money、Duration）底层用 float 存储，但 __int__ 应表达“整数部分”语义，而非强制转换。比如 Duration(seconds=5.8) 转 int 应是 5 秒，不是 6。
- 用
math.trunc()或直接int(x)（两者对正负数行为一致，且不四舍五入） - 避免
round()—— 它返回float，且语义不符 - 若需向上/向下取整，应明确使用
math.floor()或math.ceil()，并再套一层int()强制转类型 - 示例：
def __int__(self): return int(math.trunc(self._seconds))
什么时候该拒绝转换并抛出异常
不是所有对象都适合转成整数。__int__ 不是“尽力而为”，而是“明确定义”。比如一个表示颜色的 RGB 对象，没有单一整数含义；或一个带单位的 Distance(meters=1.5)，若业务要求必须是整米才允许转换，则需校验。
- 当对象语义上无自然整数映射时，直接 raise
TypeError("int() argument must be a string, a bytes-like object or a real number") - 当存在精度风险且业务敏感时（如金融金额未对齐最小单位），raise
ValueError("cannot convert to int: value has fractional cents") - 不要静默返回 0 或默认值 —— 这会让调用方误以为转换成功
__int__ 和 __index__ 的关键区别
两者都涉及整数转换，但用途完全不同：__int__ 用于 int() 显式转换；__index__ 用于切片、bin()、hex() 等需要“可索引整数”的上下文。多数情况下只需实现 __int__，除非你的类还打算被用作序列索引或位运算操作数。
立即学习“Python免费学习笔记（深入）”；
-
__index__必须返回int，且常被用于底层 C API，要求更严格（例如不能有副作用） - 如果只实现了
__int__，但没实现__index__，则[1,2,3][my_obj]会报TypeError: 'MyClass' object cannot be interpreted as an integer - 若两者逻辑一致，可让
__index__ = __int__（绑定方法），但注意这仅在无参数时安全
__int__ 看似简单，它一旦被调用，就代表你向外界承诺了“这个对象有一个明确、无歧义、可丢失精度的整数视图”——这个契约比写几行代码重得多。 
