match-case 匹配失效主因是case模式违反绑定规则或缩进错误：裸名如error是捕获模式而非字面量匹配，须写"error"；缩进不齐导致syntaxerror；类匹配需定义__match_args__；失败不报错，需检查分支顺序。
match-case 匹配失效，90% 是因为 case 下的模式写法违反了 Python 的绑定规则或缩进错位，而不是“语法不支持”。
case 后面跟变量名会无条件捕获，不是“匹配值”
很多人写成这样以为是在匹配字符串 "error"：
match status:
case error: # ❌ 这里 error 是一个变量名，不是字面量！
print("出错了")
结果发现不管 status 是什么，这个 case 都被命中——因为 error 是「捕捉模式（capture pattern）」，它会把 status 的值直接赋给变量 error，等价于 error = status。
python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能，主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践；生成安全服务方案文档；核心要点生成技术架构设计文档；生成任何需要专业排版的Word文档；核心库 : python-docx；使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns；标准代码模板；1. 文档初始化；2. 字体设置（必须！它将相关步骤、工具调用和结果整理方式集
- 想匹配字面量字符串，必须加引号：
case "error": - 想同时做匹配和绑定，用命名子模式：
case "error" as e:，此时e才是绑定的变量 - 所有未加引号、未加括号、未带类型注解的裸名，都会被解释为变量绑定，不是比较
嵌套结构匹配时缩进错一格，整个 case 就不生效
match 是复合语句，它的每个 case 子句体必须严格缩进，且所有 case 必须对齐。常见翻车点：
match data:
case {"code": 404, "msg": msg}:
print("Not found") # ❌ 缩进错误：这行不在 case 体内，match 会报 SyntaxError
- Python 要求
case后的代码块必须缩进（通常 4 空格），且不能和上层match对齐 - 如果用了多行字典/元组模式，换行后继续缩进要一致，否则解析器可能误判为新语句
- Black 格式化会自动修复这类缩进，但手动改过之后没跑
black容易漏掉
class 模式匹配失败，多半是没定义 __match_args__
用 case MyClass(attr=...) 匹配自定义类实例时，如果没显式声明 __match_args__，Python 默认只允许按位置匹配（即 case MyClass(...)），而拒绝关键字形式。
- 不加
__match_args__，case Circle(radius=1)会静默跳过，不会报错，但也不匹配 - 正确做法是在类中定义：
__match_args__ = ("radius",)，才能支持radius=1写法 - 如果类继承自
dataclass或NamedTuple，Python 会自动推导__match_args__；普通 class 不会
最隐蔽的问题是：匹配失败时 Python 不抛异常，只是跳到下一个 case 或 case _，所以你得确认「本该命中的 case 没有被更靠前的 case 意外捕获」，尤其是裸变量名和 case _ 的顺序。别假设它“应该走这里”，print 出来或用 debugger 单步看实际走了哪个分支。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
