如何让Python的re.sub输出每次替换详情（含分组场景）

要实现re.sub的verbose日志输出，核心是在替换过程中捕获匹配内容和实际替换结果——你遇到的分组场景问题，本质是当repl参数为字符串时，re.sub会自动解析反向引用，但如果把字符串传给自定义函数返回，反向引用不会被解析，导致返回原始的\2\1这类文本。

下面是两种高效的解决方案：

方案一：复用正则公开API解析反向引用 #

直接利用match.expand()方法解析反向引用，既保证替换逻辑和原生re.sub完全一致，又能打印日志：

import re

def verbose_sub_with_groups(pattern, repl_str, text, verbose=False):
    compiled_pattern = re.compile(pattern)
    
    def log_replacement(match):
        # 解析反向引用，得到实际要替换的内容
        actual_replacement = match.expand(repl_str)
        if verbose:
            print(f"Replacing '{match.group()}' with '{actual_replacement}'...")
        return actual_replacement
    
    return compiled_pattern.sub(log_replacement, text)

# 测试分组替换
result = verbose_sub_with_groups(r"([A-Z]+)(\d+)", r"\2\1", "ABC123 DEF456", verbose=True)
print(result)
# 日志输出：
# Replacing 'ABC123' with '123ABC'...
# Replacing 'DEF456' with '456DEF'...
# 最终结果：123ABC 456DEF

方案二：通用封装兼容所有替换场景 #

如果需要同时支持字符串repl和自定义函数repl，可以写一个通用的verbose_sub工具函数，覆盖所有re.sub的使用场景：

import re

def verbose_sub(pattern, repl, string, verbose=False, **kwargs):
    """带日志输出的re.sub封装，兼容字符串和函数类型的repl参数"""
    if isinstance(repl, str):
        # 处理字符串类型的repl（含反向引用）
        compiled = re.compile(pattern)
        def repl_func(match):
            actual = match.expand(repl)
            if verbose:
                print(f"Replacing '{match.group()}' with '{actual}'...")
            return actual
        return compiled.sub(repl_func, string, **kwargs)
    
    elif callable(repl):
        # 处理自定义函数类型的repl
        def wrapped(match):
            result = repl(match)
            if verbose:
                print(f"Replacing '{match.group()}' with '{result}'...")
            return result
        return re.sub(pattern, wrapped, string, **kwargs)
    
    else:
        raise ValueError("repl参数必须是字符串或可调用对象")

# 测试简单字符串替换
verbose_sub(r"\d+", "NUMBER", "this is 123 TEST 456", verbose=True)
# 日志：Replacing '123' with 'NUMBER'... / Replacing '456' with 'NUMBER'...

# 测试自定义函数替换
def double_num(match):
    return str(int(match.group()) * 2)
verbose_sub(r"\d+", double_num, "123 456", verbose=True)
# 日志：Replacing '123' with '246'... / Replacing '456' with '912'...

注意事项 #

• match.expand()是Python正则模块的公开API，比内部函数re._expand更稳定，且能完美解析命名分组（如\g<group_name>）等复杂反向引用。
• 通用封装函数支持传递re.sub的所有额外参数（如count、flags），完全兼容原生用法。

内容的提问来源于stack exchange，提问作者Zachary