Python正则中如何用变量替换匹配分组而非整段匹配结果

你碰到的这个问题核心是字符串格式化和正则分组引用的符号冲突了！原代码里用%s格式化字符串时，$1被当成了普通文本保留下来，正则引擎根本没认出这是要引用第一个捕获分组，所以才会输出带$1的错误结果。

问题根源拆解 #

原代码中的这一行：

subst = r"$1%s" % re.escape(replaceVariable)

虽然r"$1"是原始字符串，但%格式化操作会直接把$1当作字面量处理，最终生成的subst是"$1New_Name.stp"，正则的re.sub接收到这个字符串后，自然会把$1当成普通文本替换进去，而不是引用分组内容。

正确实现方案 #

这里有几种简单的修复方式，都能让正则正确识别$1分组引用：

方法1：字符串拼接（最直观）

直接把$1的原始字符串和转义后的变量拼接，避免格式化操作干扰分组标识：

import re

content = "FILE_NAME( /* name */ 'test_name_to_replace.stp', /* time_stamp */ '2018-05-28T14:34:32+02:00', /* author */ (''), /* organization */ (''),"
replaceVariable = "New_Name.stp"
regex = r"(name.*\n*').*.stp"
# 用字符串拼接代替%格式化
subst = r"$1" + re.escape(replaceVariable)
new_content = re.sub(regex, subst, content, flags=re.MULTILINE)

print(new_content)

方法2：使用str.format()

如果习惯用格式化语法，可以用format()，它不会影响$1的含义：

subst = r"$1{}".format(re.escape(replaceVariable))

方法3：Python 3.6+ 用f-string（更简洁）

用原始格式化字符串rf""，让$1保持原样，同时插入变量：

subst = rf"$1{re.escape(replaceVariable)}"

优化建议（可选） #

你的正则表达式r"(name.*\n*').*.stp"可以再精准一点，用[^']*代替.*，避免意外匹配到后面的单引号：

regex = r"(name.*')([^']*)\.stp"
subst = r"\1" + re.escape(replaceVariable)  # 这里用\1和$1效果一样

这样能确保只替换单引号内的文件名部分，不会出现匹配范围过大的问题。

最终正确输出 #

执行上述代码后，你会得到预期的结果：

FILE_NAME( /* name / 'New_Name.stp', / time_stamp / '2018-05-28T14:34:32+02:00', / author / (''), / organization */ (''),

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