__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 UI 自动化技能包 —— 用 Python 控制你的 Mac

让 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）。

• 若希望保持类型一致性，返回新实例而非裸值（如 return MyNumber(result)）
• 对整数指数，优先用整数算法（避免 ** 触发浮点路径）；可检查 isinstance(other, int) 分支处理
• 负指数（如 my_obj ** -1）会生成浮点或分数，需明确是否支持；不支持就返回 NotImplemented 或抛 ValueError
• 复数、Decimal 等类型传入时，__pow__ 可能收到非 int/float，别假设输入类型

真正难的不是写出 pow，而是想清楚它在哪种组合下会被调用、谁传什么进来、谁该返回 NotImplemented、谁该负责类型守门——这些边界稍不留意，运算符就静默失效或行为错乱。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！