match-case 是结构化模式匹配，支持解包、类型校验与变量绑定；常见错误是 case x 误作值匹配实为绑定，应改用字面量或守卫条件。
match-case 语句不是 switch 的 Python 翻译，它做的是结构化模式匹配——能解包、能校验类型、能绑定变量，但写法稍不注意就会掉进“看似匹配、实则跳过”的坑里。
match-case 基本写法和常见错误现象
最常出错的是把 case 当成简单值判断：比如写 case x: 本意是匹配变量 x 的值，结果却成了「声明一个叫 x 的新变量并捕获任意值」。Python 不会去查作用域里有没有同名变量，它直接绑定。
- ✅ 正确写法：用字面量或带括号的常量，如
case 42:、case "error":、case [1, 2, _]: - ❌ 错误写法：单独写
case status:（这等价于通配，且会覆盖原有status变量） - ⚠️ 警惕陷阱：想匹配变量值，得显式写成
case value if value == status:或改用if
如何安全地匹配变量值或枚举成员
如果你真想根据某个变量的当前值做分支，match 并非最优解；但若该变量是枚举或有固定结构，就非常合适。例如处理 HTTPStatus：
from http import HTTPStatus
def handle_status(status):
match status:
case HTTPStatus.OK:
return "Success"
case HTTPStatus.NOT_FOUND:
return "Missing"
case HTTPStatus.INTERNAL_SERVER_ERROR:
return "Oops"
case _:
return "Unknown"
- 枚举成员匹配靠的是对象身份（
is），不是值比较，所以安全可靠 - 若用普通整数代替枚举，就得写成
case 200:，不能写case code:（又掉进绑定陷阱） - 需要同时检查值和类型时，可用
case int() as n if n > 0:—— 先确认是int，再绑定为n，再加守卫条件
用模式匹配解包复杂数据结构
这是 match 最不可替代的地方：一行拆开嵌套结构并校验形状。比如解析 API 返回的 JSON-like 数据：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
response = {"data": [1, 2, 3], "error": None}
match response:
case {"data": list(items), "error": None}:
print("Got items:", items)
case {"error": str(msg)}:
print("Error:", msg)
case {"data": _, "error": _}:
print("Malformed response")
-
{"data": list(items), "error": None}同时做了三件事：确认是 dict、键存在、值类型/值匹配，并把data的值绑定给items - 守卫条件（
if）必须放在case行末，不能缩进到下一行 - 注意
list(items)匹配任意列表并绑定整个列表；想匹配“至少两个元素”，得写[a, b, *rest]
match-case 和 if-elif-else 的实际取舍建议
别为了用而用。当出现以下情况时，优先选 if：
- 判断逻辑含副作用（如调用函数、修改状态）——
match本身不执行计算，只做匹配 - 分支条件是动态的（比如从配置读阈值）、或涉及浮点比较、范围重叠判断
- 你只是想比对几个字符串/数字，且没有结构要解包，
if status == "pending": ...更直白 - 目标环境可能低于 Python 3.10（
match是语法级特性，无法降级兼容）
真正值得上 match 的场景，是你在反复写 isinstance(x, tuple) and len(x) == 2 and isinstance(x[1], dict) 这类检查——这时候模式匹配不是炫技，是删代码。
