绝大多数正则问题源于原始字符串误用、编译标志不当、贪婪模式错误或^/$作用域混淆；务必用r""定义模式，分清match/search/fullmatch，优先使用.*?和否定字符类。

Python 里写错正则，十有八九不是逻辑问题，而是 re 模块行为理解偏差或字符串转义翻车。直接上结论：绝大多数“匹配不到”“多匹配了”“报错 error: bad escape”，都出在原始字符串、编译标志、贪婪模式或 ^/$ 的作用域上。

忘记用 raw string 写正则模式

Python 字符串本身会先处理反斜杠，比如 "\d" 实际传给 re 的是 "d"（因为 \d 不是合法的 Python 转义），结果正则引擎根本没见过 \d。

• 永远优先用 r"pattern"，例如 r"\d{3}-\d{4}"，而不是 "\d{3}-\d{4}"
• 如果非要用普通字符串，得双写反斜杠："\\d{3}-\\d{4}" —— 容易漏、难读、不推荐
• 函数参数如 re.sub(r"old", r"new", text) 中的替换字符串也建议加 r，避免 \1 被误当成 ASCII 控制字符

re.match() 和 re.search() 混用导致“匹配失败”

re.match() 只从字符串开头匹配，re.search() 才全局找。新手常以为 match 是“匹配”，结果发现明明有目标内容却返回 None。

• 要判断整行是否符合格式（如邮箱校验），用 re.fullmatch() 或在 pattern 两头加 ^ 和 $
• 想提取任意位置的数字，别用 match，改用 search 或 findall
• 注意：即使用了 ^，search 仍可能匹配到开头以外的位置（因为 ^ 在多行模式下匹配每行开头）

贪婪匹配 + 错误的边界符号引发“吃太多”

像 .* 默认是贪婪的，遇到 "a123b456c" 和 pattern r"a.*c"，会匹配整个字符串，而不是想要的 "a123b456c" 中最短的 "a123b456c" —— 等等，这例子其实没错？问题常出在更隐蔽的地方，比如 r".*" 匹配 HTML 片段时，会跨标签吞掉中间所有内容。

• 用非贪婪量词：.*?、+、{2,5}?
• 避免用 .* 匹配结构化文本；优先用否定字符类，例如 r"[^"
• re.DOTALL 标志会让 . 匹配换行符，开启前确认是否真需要——多数情况不需要

re.compile() 编译后忘记传参或复用出错

预编译对象（re.Pattern）调用方法时，不再接受 flags 参数；且 sub() 的 count 参数必须显式传，不能靠默认值“猜”。

pattern = re.compile(r"\d+", re.IGNORECASE)  # flags 在 compile 时已固定
pattern.search("abc123")     # ✅ 正确
pattern.search("abc123", re.IGNORECASE)  # ❌ TypeError: unexpected keyword argument 'flags'
pattern.sub("X", "a1b2c3", count=1)  # ✅ 只替换第一个
pattern.sub("X", "a1b2c3")           # ✅ 默认全部替换

• 编译后的 pattern 不再支持运行时改 flag，要不同 flag 就另建一个
• 常用 flag 建议写全称：re.IGNORECASE 比 re.I 更易维护
• 大量重复使用同一 pattern 时才值得编译；临时一两次用 re.search(r"...", text) 更清晰

正则真正难的不是语法，而是你写的 pattern 在 Python 字符串层、re 引擎层、以及目标文本的实际结构之间，到底经历了几次“解释”。每次 None 返回或意外截断，优先查这四点：raw string、match/search 语义、贪婪控制、compile 后的调用方式。