re.sub 的替换参数必须传函数对象而非调用结果，函数签名须为单参数 m（Match 实例），通过 m.group()、m.start() 等访问匹配信息，返回 None 即为空字符串，需显式处理所有分支。
re.sub 的函数式替换参数怎么传？
必须传一个可调用对象（函数或 lambda），不能传函数调用结果。常见错误是写成 re.sub(pattern, replace_func(), text)，这会立刻执行函数并把返回值当替换字符串——而 re.sub 期望的是函数本身，它会在每次匹配时自动传入 Match 对象。
正确写法是：re.sub(pattern, replace_func, text) 或 re.sub(pattern, lambda m: f"X{m.group(1)}Y", text)。注意函数签名必须是单参数 m（Match 实例），否则会报 TypeError: replace_func() takes 0 positional arguments but 1 was given。
如何在替换函数里访问匹配的分组和位置信息？
Match 对象提供完整上下文：除了 m.group(0)（整个匹配）、m.group(1)（第一捕获组），还能用 m.start()、m.end() 获取索引，m.span() 返回元组，m.string 拿到原始文本。这些对实现「上下文感知替换」很关键，比如只在段首替换、或根据前/后字符决定替换内容。
- 若正则含命名组，优先用
m.group("name")而非数字索引，避免因括号嵌套导致序号偏移 -
m.groupdict()返回字典，适合多组、逻辑复杂的场景 - 注意：
m.group()在无匹配组时返回None，直接拼接会引发TypeError，需显式判空
为什么替换函数返回 None 会导致空字符串？
re.sub 规定：替换函数返回 None 时，等价于返回空字符串 ""。这不是 bug，而是设计行为。容易踩坑的地方是函数里写了条件分支但漏了 else，例如：
立即学习“Python免费学习笔记（深入）”；
def guard_replace(m):
if m.group(1).isupper():
return "[UPPER]" + m.group(1)
# 忘了 else，这里隐式返回 None → 替换为空串解决方式只有两种：显式补全所有分支，或默认返回 m.group(0)（即保持原样）。
另外，返回非字符串类型（如 int、list）会直接抛 TypeError，Python 不做隐式转换。
性能敏感时，要不要预编译正则 + 复用 Match 对象？
对长文本或高频调用，re.compile() 是必须的。但要注意：预编译只加速匹配过程，不影响替换函数执行；Match 对象本身不缓存，每次匹配都新建实例，无法复用。
真正影响性能的点在于替换函数内部逻辑：
- 避免在函数内重复调用
re.search或打开文件 - 如果需要查表替换，把字典提前构建好，别在每次调用里
json.load - 字符串拼接用
f-string或"".join()，不用+=
动态替换的复杂度往往不在正则引擎，而在你写的那个函数里——它被调用多少次，就执行多少次。
