本文介绍一种专业、简洁且健壮的方式，为 Python 的 re.sub 添加“详细模式”（verbose mode），使其在执行每次正则替换时自动打印原始匹配内容与实际替换结果，完整支持 , 等反向引用及函数式替换。
本文介绍一种专业、简洁且健壮的方式，为 python 的 `re.sub` 添加“详细模式”（verbose mode），使其在执行每次正则替换时自动打印原始匹配内容与实际替换结果，完整支持 ``, `` 等反向引用及函数式替换。
在调试复杂正则替换逻辑（尤其是多层 re.sub 级联处理长文本）时，仅靠最终输出难以定位问题：是匹配错了？分组没捕获？还是反向引用未正确展开？原生 re.sub 不提供替换日志功能，但借助 match.expand() 方法，我们可以安全、准确地还原真实替换值，并同步记录——无需手动解析转义序列或模拟 re.sub 的内部逻辑。
核心原理在于：re.Match.expand(repl_str) 会严格按照 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)✅ 优势说明：
- ✅ 完全保留 re.sub 行为：支持 count, flags，不改变匹配逻辑；
- ✅ 正确处理所有反向引用语法：, g, g
，甚至嵌套命名组； - ✅ 兼容函数式 repl：如 lambda m: f"[{m.group(1).upper()}]" 或条件逻辑；
- ✅ 日志含精确位置信息（offset）和 repr 格式化输出，便于排查空格、换行符等不可见字符。
? 使用示例：
# 示例 1：字符串替换（含 ）
print(sub2(r'(d)(d)(d)', r'', 'abc123def456', verbose=True))
# 输出：
# offset 3: '123' -> '321'
# offset 10: '456' -> '654'
# → 'abc321def654'
# 示例 2：函数式替换（混合逻辑）
print(sub2(r'([a-z]+)(d+)',
lambda m: f"{m.group(2)}_{m.group(1).upper()}",
'hello123 world45', verbose=True))
# 输出：
# offset 0: 'hello123' -> '123_HELLO'
# offset 9: 'world45' -> '45_WORLD'
# → '123_HELLO 45_WORLD'⚠️ 注意事项：
- match.expand() 仅作用于字符串型 repl；若 repl 是函数，需确保其返回值为字符串（否则会抛出 TypeError）；
- 日志在替换前打印，因此可清晰观察「输入→预期→实际」链条；
- 生产环境请关闭 verbose，避免 I/O 开销影响性能；
- 若需进一步定制日志（如写入文件、添加时间戳），只需修改 print(...) 行即可，函数结构高度可扩展。
通过 sub2，你获得了一个即插即用、语义清晰、行为可靠的“可观察正则替换器”——从此告别盲调 re.sub，让每一次替换都透明、可控、可追溯。
