本文详解如何在 Python 自定义类（如四元数 Quat）中正确实现 __mul__ 方法以支持链式乘法运算，重点指出因命名错误（如 ___mul__）导致的 TypeError 问题，并提供可运行示例与最佳实践。
本文详解如何在 python 自定义类（如四元数 quat）中正确实现 `__mul__` 方法以支持链式乘法运算，重点指出因命名错误（如 `___mul__`）导致的 `typeerror` 问题，并提供可运行示例与最佳实践。
在 Python 中，为自定义类启用 * 运算符需正确定义特殊方法 __mul__（注意：是两个下划线 + mul + 两个下划线，即 __mul__）。若误写为 ___mul__（三个下划线）、__mul_ 或其他变体，Python 将完全忽略该方法，导致调用 a * b 时抛出 TypeError: unsupported operand type(s) for *: 'Quat' and 'Quat'——这正是本例中四元数类 Quat 遇到的核心问题。
以下为修复后的完整、可运行的 Quat 类关键代码（已修正命名并补充必要逻辑）：
import math
from typing import Any
# 假设 Vec3 已正确定义（含 dot、cross、normalised、is_zero 等方法）
# 此处为简化演示，提供最小可行 Vec3 桩（实际项目请替换为真实实现）
class Vec3:
def __init__(self, x=0.0, y=0.0, z=0.0):
self.x, self.y, self.z = x, y, z
def dot(self, other):
return self.x * other.x + self.y * other.y + self.z * other.z
def cross(self, other):
return Vec3(
self.y * other.z - self.z * other.y,
self.z * other.x - self.x * other.z,
self.x * other.y - self.y * other.x
)
def normalised(self):
mag = math.sqrt(self.x**2 + self.y**2 + self.z**2)
return Vec3(self.x/mag, self.y/mag, self.z/mag) if mag != 0 else Vec3(1.0, 0.0, 0.0)
@property
def is_zero(self):
return abs(self.x) < 1e-10 and abs(self.y) < 1e-10 and abs(self.z) < 1e-10
class Quat:
@classmethod
def from_axis_angle(cls, _axis=Vec3(1.0, 0.0, 0.0), _angle=0.0):
w = math.cos(_angle * 0.5)
x = _axis.x * math.sin(_angle * 0.5)
y = _axis.y * math.sin(_angle * 0.5)
z = _axis.z * math.sin(_angle * 0.5)
return cls(w, x, y, z)
def __init__(self, _w, _x, _y, _z):
self.w = _w
self.x = _x
self.y = _y
self.z = _z
# ✅ 正确：双下划线 __mul__（非 ___mul__！）
def __mul__(self, _rhs):
if not isinstance(_rhs, Quat):
return NotImplemented # 支持与其他类型（如标量）的扩展，但此处仅处理 Quat
lhs_vec = Vec3(self.x, self.y, self.z)
rhs_vec = Vec3(_rhs.x, _rhs.y, _rhs.z)
w = self.w * _rhs.w - lhs_vec.dot(rhs_vec)
xyz = (self.w * rhs_vec) + (_rhs.w * lhs_vec) + lhs_vec.cross(rhs_vec)
return Quat(w, xyz.x, xyz.y, xyz.z)
# ✅ 可选：实现 __rmul__ 以支持标量 * Quat（如 2.0 * q），但非链式 Quat*Quat*Quat 所必需
def __rmul__(self, _lhs):
if isinstance(_lhs, (int, float)):
return Quat(_lhs * self.w, _lhs * self.x, _lhs * self.y, _lhs * self.z)
return NotImplemented
# ✅ 推荐：实现 __repr__ 便于调试
def __repr__(self):
return f"Quat({self.w:.3f}, {self.x:.3f}, {self.y:.3f}, {self.z:.3f})"
def to_axis_angle(self):
xyz = Vec3(self.x, self.y, self.z)
if xyz.is_zero:
axis = Vec3(1.0, 0.0, 0.0)
angle = 0.0
return (axis, angle)
axis = xyz.normalised()
angle = math.acos(max(-1.0, min(1.0, self.w))) * 2.0 # 防止浮点误差越界
return (axis, angle)关键注意事项与最佳实践：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 命名必须精确：__mul__ 是 Python 内置的魔术方法名，任何拼写偏差（如 ___mul__、__mul、__MUL__）均会导致方法不被识别。
- 返回新实例，而非修改自身：__mul__ 应返回新的 Quat 对象，保持不可变性（符合数学直觉与函数式编程习惯）。
- 类型检查与 NotImplemented：在 __mul__ 中检查 _rhs 类型，若不匹配应返回 NotImplemented（而非抛异常），以便 Python 尝试调用 _rhs.__rmul__(self)，提升运算符兼容性。
- 避免重复实现：原代码中 mult() 方法与 __mul__ 逻辑高度重复，建议移除 mult()，统一通过 __mul__ 提供接口，既简洁又符合 Python 惯例。
- 链式运算自动生效：一旦 __mul__ 正确实现，a * b * c 将按 (a * b) * c 自动解析，无需额外处理。
总结：运算符重载的成败常系于一个看似微小的命名细节。调试此类 TypeError 时，应首先核对魔术方法名称是否严格符合 Python 文档规范。遵循标准命名、合理返回值与类型协商机制，即可让自定义类无缝融入 Python 的运算符生态。
立即学习“Python免费学习笔记（深入）”；
