__match_args__仅控制位置模式匹配的字段顺序，不影响命名模式或值比较；必须为tuple[str, ...]且属性存在，否则运行时抛AttributeError。
直接说结论： __match_args__ 只控制 match 语句中「位置模式」（即不带属性名的元组解构）匹配哪些字段，它不改变对象结构、不参与值比较、也不影响命名模式（如 Point(x=x_val)）——用错地方就完全没效果。
为什么加了 __match_args__ 却没触发模式匹配？
常见错误是以为只要定义了 __match_args__，match 就会自动按它解构。其实它只在「位置模式」下起作用，比如 match obj: case Point(0, y): ... 这种写法才查 __match_args__；而 case Point(x=0, y=y_val) 或 case Point() 完全不看它。
- 必须是
class，且继承自object（Python 3.10+ 默认满足） -
__match_args__必须是tuple[str, ...]，元素是实例属性名（字符串），顺序决定位置模式的对应顺序 - 如果类没有定义
__match_args__，位置模式默认只匹配()（空元组），即任何非空位置模式都会失败
__match_args__ 和 __match_args__ = ("x", "y") 的实际效果
以二维点为例：
class Point:
__match_args__ = ("x", "y")
def __init__(self, x, y):
self.x = x
self.y = y
这时下面的匹配才生效：
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
-
match p: case Point(0, y): ...→ 等价于p.x == 0 and (y := p.y) -
case Point(x, 0): ...→x绑定p.x，并检查p.y == 0 -
case Point(a, b): ...→ 同时绑定a = p.x,b = p.y，不检查值
但这些写法完全忽略 __match_args__：
-
case Point(x=0): ...（命名模式，直接读属性） -
case Point(): ...（仅检查类型，不访问字段） -
case Point(0, 1, 2): ...（长度不匹配，报MatchError）
容易踩的坑：顺序、缺失属性、继承干扰
__match_args__ 是严格按元组顺序映射属性的，一旦顺序错或属性不存在，运行时就抛 AttributeError：
- 写成
__match_args__ = ("x", "z")，但实例没z属性 → 匹配时炸 - 子类没重写
__match_args__，但父类定义了 → 子类也沿用父类顺序，可能和子类实际字段对不上 - 想让
case MyData(a, b, c)匹配三个字段，但__match_args__只写了两个 → 第三个位置模式直接失败 - 动态生成属性（如用
__setattr__或__slots__控制）时，确保__match_args__列出的属性在匹配时一定存在
最常被忽略的一点：它只服务于 PEP 634 的 match 语法糖，和 isinstance、getattr、序列协议都无关——别指望靠它“统一字段访问接口”。
