Python的re.sub()回调函数是一种强大而灵活的正则替换机制，它通过接收re.Match对象（而非原始字符串）来动态生成替换内容，支持分组提取、位置定位、命名组访问等丰富上下文信息，广泛应用于千分位格式化、大小写翻转、自动编号、日期重组等智能文本处理场景；掌握其正确用法——如确保返回字符串、安全处理可能为None的捕获组、善用命名组提升可读性——能让正则替换从简单字符替换跃升为具备逻辑判断与数据转换能力的“智能重构”工具。

Python 中 re.sub() 的回调函数（即 repl 参数传入一个函数）是一种强大且灵活的替换方式，适用于需要动态生成替换内容的场景，比如根据匹配内容做计算、转换大小写、添加序号、提取后重组等。

回调函数的基本要求

传给 re.sub() 的回调函数必须接收一个 re.Match 对象作为唯一参数，并返回一个字符串（作为替换结果）。如果返回 None 或非字符串类型，会引发 TypeError。

• 函数签名形如：def my_replace(match: re.Match) -> str:
• match.group() 获取整个匹配文本；match.group(1) 获取第一个捕获组，依此类推
• 可结合 match.start()、match.end()、match.span() 获取位置信息

常见实用场景示例

① 给数字加千分位逗号
匹配连续数字，再用 int() 转换后格式化：

import re
text = "价格：12345 元，销量：987654"
result = re.sub(r'\d+', lambda m: f'{int(m.group()):,}', text)
# → '价格：12,345 元，销量：987,654'

② 大小写翻转（仅字母）
利用 str.swapcase()：

text = "Hello World! 123"
result = re.sub(r'[a-zA-Z]+', lambda m: m.group().swapcase(), text)
# → 'hELLO wORLD! 123'

③ 替换为带序号的标签
用闭包或外部计数器实现编号：

counter = 0
def add_number(match):
    global counter
    counter += 1
    return f"[{counter}] {match.group()}"
text = "apple banana cherry"
re.sub(r'\w+', add_number, text)
→ '[1] apple [2] banana [3] cherry'

注意捕获组与命名组的使用

回调中可安全访问所有定义的捕获组。命名组更清晰易读：

text = "2023-04-01"
pattern = r'(?P\d{4})-(?P\d{2})-(?P\d{2})'
result = re.sub(pattern, lambda m: f"{m.group('year')}年{m.group('month')}月{m.group('day')}日", text)
# → '2023年04月01日'

• 用 m.group('name') 访问命名组，比数字索引更健壮
• 若某组未参与匹配（例如分支中未命中），m.group('name') 返回 None，需判空

避免常见错误

❌ 错误：在回调里直接修改原字符串
回调函数只负责返回替换内容，不操作原始字符串或全局状态（除非有意为之）。

❌ 错误：忽略未匹配的捕获组
例如 (a)?b 匹配 "b" 时，group(1) 是 None，直接调用 .upper() 会报错。

✅ 安全写法：

re.sub(r'(a)?(b)', lambda m: (m.group(1) or '').upper() + (m.group(2) or ''), 'b')

掌握回调函数的关键是理解它接收的是 Match 对象，而非字符串本身——所有上下文信息（匹配内容、位置、分组）都从中获取。合理利用它，能让正则替换从“静态替换”升级为“智能重构”。

以上就是《Python正则替换回调函数使用教程》的详细内容，更多关于的资料请关注golang学习网公众号！