本文介绍如何为 Python 的 re.sub 添加“详细模式”（verbose mode），使其在每次成功匹配并替换时打印原始匹配内容与实际替换结果，尤其支持 , 等反向引用语法的正确解析与日志记录。
本文介绍如何为 python 的 `re.sub` 添加“详细模式”（verbose mode），使其在每次成功匹配并替换时打印原始匹配内容与实际替换结果，尤其支持 ``, `` 等反向引用语法的正确解析与日志记录。
在正则替换调试过程中，仅靠最终结果难以判断多层 re.sub 调用是否按预期生效，尤其是涉及捕获组（如 (d+)([a-z]+)）和反向引用（如 r"_"）时。Python 原生 re.sub 不提供内置 verbose 选项，但可通过自定义替换函数结合 match.expand() 实现精准、可读的日志输出。
关键在于：不能直接返回原始 replacement 字符串（如 r""），而应调用 matchobj.expand(replacement)。该方法会像 re.sub 内部一样，动态解析反斜杠转义和组引用，生成真实替换文本，并支持所有标准替换语法（包括 g
以下是一个轻量、通用的增强版 sub2 函数，完全兼容原生 re.sub 接口，并新增 verbose=True 参数：
import re
def sub2(pattern, repl, string, count=0, flags=0, verbose=False):
def helper(match, repl_arg):
# 处理 repl 为函数或字符串两种情况
if callable(repl_arg):
expanded_repl = match.expand(repl_arg(match))
else:
expanded_repl = match.expand(repl_arg)
if verbose:
print(f"offset {match.start()}: {match.group()!r} → {expanded_repl!r}")
return expanded_repl
return re.sub(pattern, lambda m: helper(m, repl), string, count, flags)
✅ 使用示例 1：字符串形式 replacement（含反向引用）
result = sub2(r'(d{2})(d{2})', r'/', 'date: 1234', verbose=True)
# 输出：offset 6: '1234' → '34/12'
# result == 'date: 34/12'
✅ 使用示例 2：函数形式 replacement（动态逻辑 + 日志）
result = sub2(
r'(w+):(d+)',
lambda m: f"[{m.group(2)}]{m.group(1).upper()}",
"age:25 name:alice",
verbose=True
)
# 输出：
# offset 0: 'age:25' → '[25]AGE'
# offset 9: 'name:alice' → '[alice]NAME' ← 注意：此处因模式不匹配，实际不会触发（修正：应为 r'(w+):(w+)'）
# 正确示例：sub2(r'(w+):(w+)', lambda m: f"[{m.group(2)}]{m.group(1).upper()}", "name:alice", verbose=True)
⚠️ 注意事项：
- match.expand() 仅接受字符串（或可转为字符串的返回值），若 repl 是函数，必须确保其返回字符串；
- 日志中的 offset 指匹配起始索引，便于定位原文位置；
- verbose=True 不影响性能逻辑，仅增加 print 开销，生产环境请关闭；
- 该方案完全绕过 re.sub 对 replacement 字符串的“自动转义陷阱”，避免出现字面 等未解析结果。
总结：通过封装 re.sub 并利用 Match.expand() 解析 replacement，我们既能保留原生正则能力（包括命名组、条件替换等），又能获得清晰、结构化的替换过程日志——这是高效调试复杂文本处理流水线的关键实践。
