模式也是代码
复杂正则之所以难维护，是因为它压缩了本该分层表达的逻辑：结构、约束、取值全挤在一行符号里。把模式当代码对待，做分段、命名与注释，维护成本会显著下降。
三条实用原则
一是分段：用非捕获分组把模式切成有语义的几块；二是命名：需要取值的部分改成命名分组，代码里按名字读取；三是留痕：在模式旁写清意图与样例，说明输入长什么样、为什么这样写。
基本信息
| 分段手段 | 自由间距模式配合缩进，非捕获分组标注结构 |
|---|---|
| 取值手段 | 命名分组替代数字编号，读取代码不再依赖顺序 |
| 注释手段 | 自由间距模式的行内注释，或模式外侧的文档说明 |
| 复用手段 | 把可复用的片段抽成命名常量，拼接成完整模式 |
| 验证手段 | 为模式准备正例与反例样本，纳入测试用例 |
| 边界 | 模式不应承担业务规则的完整说明，规则文档仍要单独维护 |
典型使用场景
- 接手历史遗留的复杂模式，需要先理解再修改
- 为邮箱、日志行、URL 等格式编写可评审的模式
- 多人协作中让模式改动可以在评审里被看懂
- 模式被多处复用时，把公共片段抽成常量统一维护
- 排查线上问题时快速定位模式中哪一段负责哪部分约束
可读写法的组织方式
可读写法的组织方式
import re
SEP = r'[-/.]' # 公共分隔符片段，单独维护
DATE = rf'(?P<y>\d{{4}}){SEP}(?P<m>\d{{1,2}})' # 复合片段复用常量
pat = re.compile(rf'''
\A(?P<date>{DATE})\Z # 整串只允许日期结构
''', re.VERBOSE)
m = pat.fullmatch('2026-10')
print(m.group('y'), m.group('m')) # 按名字取值，不依赖编号顺序
# 反例样本同样要写进测试：例如两位年份、缺分隔符的输入常见坏味道与改法
| 症状 | 问题 | 改法 |
|---|---|---|
| 一行数百字符 | 无法逐段核对 | 自由间距分段并加注释 |
| 大量数字组引用 | 插入新括号即错位 | 改为命名分组 |
| 到处重复同一片段 | 改一处漏一处 | 抽成常量统一复用 |
| 无样本可测 | 改动后无法验证 | 补正例与反例测试 |
把模式拆成常量拼接时要注意各片段的转义层数与分组编号关系：命名分组可以避免编号错位，而拼接点处的量词作用范围需要重新确认。
任何可读性改造都要以行为不变为前提。改造前后用同一批正例与反例跑一遍，结果若有差异，先查清原因再决定是否保留改动。