re.sub()回调函数接收re.Match对象并返回字符串，用于动态替换；支持分组提取、位置获取及命名组访问，常见于千分位格式化、大小写翻转、序号添加等场景。
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()}"
<p>text = "apple banana cherry"
re.sub(r'\w+', add_number, text)</p><h1>→ '[1] apple [2] banana [3] cherry'注意捕获组与命名组的使用
回调中可安全访问所有定义的捕获组。命名组更清晰易读：
text = "2023-04-01"
pattern = r'(?P<year>\d{4})-(?P<month>\d{2})-(?P<day>\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() 会报错。
✅ 安全写法：
立即学习“Python免费学习笔记（深入）”；
re.sub(r'(a)?(b)', lambda m: (m.group(1) or '').upper() + (m.group(2) or ''), 'b')
掌握回调函数的关键是理解它接收的是 Match 对象，而非字符串本身——所有上下文信息（匹配内容、位置、分组）都从中获取。合理利用它，能让正则替换从“静态替换”升级为“智能重构”。
