如何利用Python的__total_ordering__简化类比较？-Python教程-PHP中文网

@total_ordering不生效的根本原因是未正确定义__eq__和且仅一个核心比较方法（如__lt__）；若同时实现__lt__和__le__等多个比较方法，装饰器将放弃推导，退化为默认的内存地址比较。

如何利用python的__total_ordering__简化类比较？

为什么 `@total_ordering` 有时不生效？

根本原因通常是类里没正确定义 __eq__ 和**且仅一个**核心比较方法（如 __lt__）。@total_ordering 不会自动补全 __eq__，也不接受多个已实现的比较方法共存——比如同时写了 __lt__ 和 __le__，它就直接放弃推导，所有比较操作都会回退到默认的 id() 比较，导致结果完全不可预期。

常见错误现象：a 返回 <code>True，但 a 却返回 <code>False；或者两个逻辑相等的对象 a == b 为 False。

必须显式实现 __eq__（返回布尔值，不能省略）
只能实现 __lt__、__le__、__gt__、__ge__ 中的**且仅一个**（推荐用 __lt__）
不能在同一个类里手动实现多个，否则 @total_ordering 彻底静默失效

`@total_ordering` 要求哪些方法必须存在？

装饰器只依赖两个锚点：你写的那个核心方法（比如 __lt__），和你亲手写的 __eq__。其余四个（__le__、__gt__、__ge__、__ne__）它才帮你生成。

注意：__ne__ 是基于 __eq__ 取反生成的，所以如果你的 __eq__ 有 bug，!= 也会错；__le__ 是用 not (other 实现的，这意味着它隐式依赖 <code>__lt__ 的正确性与完备性（比如要能处理 self 和 other 类型不一致的情况）。

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

__eq__ 必须返回 NotImplemented 或布尔值，不能抛异常（否则 == 和 != 都崩）
如果类支持与其他类型比较（如 int），__lt__ 里需主动检查 isinstance(other, YourClass)，否则 @total_ordering 生成的 __le__ 会把 NotImplemented 当 False 处理，导致 obj 返回 <code>False 而不是 NotImplemented

实际用例：带优先级的 Task 类

假设你要排序任务，按 priority 升序，同优先级时按 created_at 时间戳升序。不用 @total_ordering 得写 6 个方法；用它，只写 __eq__ 和 __lt__ 就够：

from functools import total_ordering
from datetime import datetime

@total_ordering
class Task:
    def __init__(self, name, priority, created_at=None):
        self.name = name
        self.priority = priority
        self.created_at = created_at or datetime.now()

    def __eq__(self, other):
        if not isinstance(other, Task):
            return NotImplemented
        return (self.priority, self.created_at) == (other.priority, other.created_at)

    def __lt__(self, other):
        if not isinstance(other, Task):
            return NotImplemented
        return (self.priority, self.created_at) 
<p>之后 <code>task1 、<code>task1 > task2</code>、<code>task1 != task2</code> 全部可用，且语义一致。关键点在于元组比较天然支持多级排序，避免手写嵌套 <code>if</code>。</code></p>

<h3>和 <code>dataclass(order=True)</code> 怎么选？</h3>
<p>如果类只是简单字段组合、且所有字段都参与比较，<code>@dataclass(order=True)</code> 更省事：它自动生成全部比较方法，连 <code>__eq__</code> 都包了。但一旦你需要自定义逻辑（比如忽略某个字段、按函数结果比较、或做类型容错），<code>@total_ordering</code> 就不可替代——<code>dataclass</code> 的 <code>order</code> 参数不支持回调或条件分支。</p>