__pow__ 不生效的主因是未按Python三路分发规则实现：左操作数调用 __pow__，右操作数需实现 __rpow__；模幂必须支持三参数签名 __pow__(self, other, mod=None) 并正确处理 mod 为 None 或非 None 的情况。
为什么 __pow__ 不生效？常见触发失败原因
直接调用 a ** b 却报 TypeError: unsupported operand type(s)，大概率不是没写 __pow__，而是它没被调用到。Python 的幂运算有三路分发逻辑：** 会先查左操作数的 __pow__，但如果右操作数实现了 __rpow__ 且左操作数返回 NotImplemented，就会 fallback 到右操作数。更隐蔽的是：如果左操作数是内置类型（如 int），而你的类是右操作数（比如 2 ** my_obj），此时根本不会进你的 __pow__，必须实现 __rpow__。
- 只实现
__pow__时，仅my_obj ** other会触发 -
other ** my_obj（如2 ** my_obj）必须靠__rpow__ - 若
__pow__返回NotImplemented（而非抛异常），Python 才会尝试__rpow__ - 模幂运算
a ** b % c会优先调用__pow__(a, b, c)三参数形式，别漏掉
如何正确实现三参数 __pow__ 支持模幂
当表达式含第三个参数（如 my_num ** 3 % 5），Python 会传入三个参数调用 __pow__(self, other, mod=None)。如果只写了双参数版本，就会触发 TypeError: pow() takes exactly 2 arguments。关键点在于：第三个参数 mod 可能为 None，不能假设它一定存在。
- 函数签名必须是
def __pow__(self, other, mod=None): - 若不支持模幂，对
mod is not None应返回NotImplemented，而非抛异常 - 若支持，需手动计算
pow(self.value, other, mod)（注意：不要直接用内置pow而不传mod，否则失去优化） - 示例：
def __pow__(self, other, mod=None): result = self.value ** other return result if mod is None else result % mod（简单场景可用；高阶场景建议用pow(self.value, other, mod)避免大数溢出）
__pow__ 和 __rpow__ 的典型配合写法
要让 my_obj ** 2 和 2 ** my_obj 都工作，两个方法都得写，且语义要一致。常见错误是 __rpow__ 直接复制 __pow__ 逻辑，但左右操作数位置反了——__rpow__(self, other) 中，self 是右操作数（你的实例），other 是左操作数（如 2），所以实际要算的是 other ** self.value。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
__pow__(self, other, mod=None)：处理self ** other -
__rpow__(self, other)：处理other ** self，注意顺序不可颠倒 - 若
other类型不支持（如字符串），在__rpow__中应返回NotImplemented，让 Python 尝试其他回退路径 - 示例：
def __rpow__(self, other): if isinstance(other, (int, float)): return other ** self.value return NotImplemented
性能与数值类型兼容性注意事项
Python 内置幂运算对整数和浮点数做了高度优化，自己实现时容易忽略隐式类型转换和精度问题。比如，__pow__ 返回 float 但用户期望仍是你的自定义类型，或整数幂结果意外变成 float（如 2.0 ** 3）。
立即学习“Python免费学习笔记（深入）”；
- 若希望保持类型一致性，返回新实例而非裸值（如
return MyNumber(result)） - 对整数指数，优先用整数算法（避免
**触发浮点路径）；可检查isinstance(other, int)分支处理 - 负指数（如
my_obj ** -1）会生成浮点或分数，需明确是否支持；不支持就返回NotImplemented或抛ValueError - 复数、Decimal 等类型传入时，
__pow__可能收到非int/float，别假设输入类型
真正难的不是写出 <strong>pow</strong>，而是想清楚它在哪种组合下会被调用、谁传什么进来、谁该返回 NotImplemented、谁该负责类型守门——这些边界稍不留意，运算符就静默失效或行为错乱。
