自定义类必须实现__match_args__才能被match解构，该类属性为元组，指定可位置解构的字段名及顺序；未定义则报typeerror，子类不继承需显式声明。
自定义类必须实现 __match_args__ 才能被 match 解构
Python 3.10 的 match 语句默认不识别任意自定义类，直接对实例做模式匹配会报 TypeError: cannot match against non-pattern object。核心原因是解释器需要知道“这个类的哪些属性可以按顺序参与解构”，而这个映射关系由 __match_args__ 显式声明。
它是一个类属性（通常为元组），列出允许在模式中按位置匹配的字段名，顺序必须与构造函数参数顺序一致（除非显式重载 __init__ 参数顺序）：
class Point:
__match_args__ = ("x", "y") # ← 关键！没有这行，下面的 match 会失败
def __init__(self, x, y):
self.x = x
self.y = y
注意：__match_args__ 只控制位置模式（如 Point(a, b)），不控制关键字模式（Point(x=a, y=b)）——后者始终可用，但无法触发解构绑定。
match 中使用 ClassName(pat1, pat2, ...) 触发解构绑定
一旦类定义了 __match_args__，就可以在 case 子句中用带括号的类名写法，让解释器自动提取对应属性值并绑定到模式变量：
p = Point(3, 4)
match p:
case Point(x, y) if x > 0: # ← x 和 y 自动绑定为 p.x 和 p.y
print(f"第一象限点：({x}, {y})")
case Point(0, 0):
print("原点")
case _:
print("其他")
- 括号内变量名不必与
__match_args__中的字段名相同（Point(a, b)也合法），只要数量和顺序匹配即可 - 支持嵌套模式，比如
Point(int(), int())可校验类型，Point(x, 0)可固定某个值 - 若类有可选参数（如
__init__(self, x, y, z=0)），__match_args__仍只列必填项；想匹配默认值需显式写进模式（如Point(x, y, 0)）
不继承、不魔改，但要注意 __match_args__ 的继承行为
子类不会自动继承父类的 __match_args__，即使没重定义也会得到 None，导致匹配失败：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
class ColorPoint(Point):
def __init__(self, x, y, color):
super().__init__(x, y)
self.color = color
<h1>❌ ColorPoint(1, 2) 在 match 中会报错：no __match_args__ defined</h1><p></p>
修复方式只有显式设置：
class ColorPoint(Point):
__match_args__ = ("x", "y", "color") # ← 必须重新声明
def __init__(self, x, y, color):
super().__init__(x, y)
self.color = color
- 如果子类只想复用父类前几个字段，可以截取：
__match_args__ = Point.__match_args__ + ("color",) -
__match_args__是类属性，不能是 property 或方法，必须是静态元组 - 动态生成（如通过
__set_name__或__init_subclass__）可行，但增加复杂度，一般不必要
替代方案：用 __match_args__ = () 禁用位置解构，强制走关键字模式
如果类字段多、顺序不稳定，或你只想支持明确命名的匹配（更易读、不易错），可以设空元组：
class Config:
__match_args__ = () # ← 禁用 Point(x, y) 这种写法
def __init__(self, host, port, debug=False):
self.host = host
self.port = port
self.debug = debug
<h1>✅ 只能这样匹配（关键字模式，不依赖 __match_args__）</h1><p>match cfg:
case Config(host=h, port=p) if p > 1024:
print(f"服务运行在 {h}:{p}")
case Config(debug=True):
print("调试模式开启")
</p>
这种写法绕过位置绑定逻辑，完全靠属性名匹配，适合配置类、DTO 等字段语义强于顺序的场景。但代价是无法用简写 Config(h, p)，且不支持“剩余字段”捕获（如 Config(x, y, *rest) 不合法）。
真正容易被忽略的是：__match_args__ 一旦定义，就锁定了位置匹配的字段集；后续增删字段时，必须同步更新它，否则模式会静默失效或绑定错位——这点比类型提示还容易漏检。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
