match-case 匹配失效主因是case模式违反绑定规则或缩进错误：裸名如error是捕获模式而非字面量匹配，须写"error"；缩进不齐导致SyntaxError；类匹配需定义__match_args__；失败不报错，需检查分支顺序。
match-case 匹配失效，90% 是因为下的模式写法违反了 Python 的绑定规则或缩进错位，而不是“语法不支持”。
case 后面跟变量名会无条件捕获，不是“匹配值”
很多人写成这样以为是在匹配字符串
：
结果发现不管
是什么，这个
都被命中——因为
是「捕捉模式（capture pattern）」，它会把
的值直接赋给变量
，等价于
。
想匹配字面量字符串，必须加引号：
想同时做匹配和绑定，用命名子模式：
，此时
才是绑定的变量
所有未加引号、未加括号、未带类型注解的裸名，都会被解释为变量绑定，不是比较
嵌套结构匹配时缩进错一格，整个 case 就不生效
是复合语句，它的每个
子句体必须严格缩进，且所有
必须对齐。常见翻车点：
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
立即学习
“
Python免费学习笔记（深入）
”；
Python 要求
后的代码块必须缩进（通常 4 空格），且不能和上层
对齐
如果用了多行字典/元组模式，换行后继续缩进要一致，否则解析器可能误判为新语句
Black 格式化会自动修复这类缩进，但手动改过之后没跑
容易漏掉
class 模式匹配失败，多半是没定义 __match_args__
用
匹配自定义类实例时，如果没显式声明
，Python 默认只允许按位置匹配（即
），而拒绝关键字形式。
不加
，
会静默跳过，不会报错，但也不匹配
正确做法是在类中定义：
，才能支持
写法
如果类继承自
或
，Python 会自动推导
；普通 class 不会
最隐蔽的问题是：匹配失败时 Python 不抛异常，只是跳到下一个
或
，所以你得确认「本该命中的 case 没有被更靠前的 case 意外捕获」，尤其是裸变量名和
的顺序。别假设它“应该走这里”，print 出来或用 debugger 单步看实际走了哪个分支。
case"error"match status:
case error: # ❌ 这里 error 是一个变量名，不是字面量！
print("出错了")
statuscaseerrorstatuserrorerror = statuscase "error":case "error" as e:ematchcasecasematch data:
case {"code": 404, "msg": msg}:
print("Not found") # ❌ 缩进错误：这行不在 case 体内，match 会报 SyntaxError
casematchblackcase MyClass(attr=...)__match_args__case MyClass(...)__match_args__case Circle(radius=1)__match_args__ = ("radius",)radius=1dataclassNamedTuple__match_args__casecase _case _