Python文本替换重复执行异常：需检测精确匹配与左邻字符

我编写了一个Python程序，目标是将文本文件中的指定搜索文本替换为目标文本。首次执行替换正常，但再次执行时无法得到预期结果。示例如下：

search_text = "something"
replacement_text = "\""+search_text+"\""

首次运行效果：

Input : something
Output : "something"

第二次运行：

Input: something
Output: ""something""

预期第二次运行应输出 not found，即当无法找到精确匹配时输出错误提示，或能获取搜索词在文本文件中的紧邻左侧字符。

当前使用的代码如下：

texterror = ["a","b","c","d"]

def dothereplace(search_text, replace_text):
    with open(filepath, "r", encoding="utf-8") as file:
        data = file.read()
        data = data.replace(search_text, replace_text)
    with open(filepath, 'w', encoding='utf-8') as file:
        file.write(data)

search_text = ""
replace_text = ""
for i in range(0,len(texterror)):
    search_text = texterror[i]
    replace_text = "\""+search_text+"\""
    dothereplace(search_text,replace_text)
    print(texterror[i],"replacement done")

问题根源 #

str.replace()会替换所有匹配的子串，第一次替换后，原文本中的something变成"something"，第二次运行时，搜索文本something依然存在于"something"的引号内部，因此会被再次替换，导致出现""something""的重复包裹问题。

解决方法 #

方案1：检查替换前后的文本变化 #

通过判断原文本中是否存在搜索词，来决定是否执行替换，并在无匹配时输出提示：

texterror = ["a","b","c","d"]

def dothereplace(search_text, replace_text):
    with open(filepath, "r", encoding="utf-8") as file:
        data = file.read()
    
    # 检查是否存在匹配项
    if search_text not in data:
        print(f"错误：未找到 '{search_text}'")
        return
    
    new_data = data.replace(search_text, replace_text)
    with open(filepath, 'w', encoding='utf-8') as file:
        file.write(new_data)
    print(f"{search_text} 替换完成")

# 简化循环写法
for item in texterror:
    search_text = item
    replace_text = f'"{search_text}"'
    dothereplace(search_text, replace_text)

方案2：正则精确匹配独立单词 #

如果需要避免替换已被引号包裹的目标词（比如已经替换过的"a"中的a），可以用正则匹配独立的单词边界：

import re

texterror = ["a","b","c","d"]

def dothereplace(search_text, replace_text):
    with open(filepath, "r", encoding="utf-8") as file:
        data = file.read()
    
    # 正则匹配独立的目标词（前后为非单词字符或文本边界）
    # re.escape()用于转义搜索文本中的特殊字符，避免正则语法冲突
    pattern = re.compile(r'\b' + re.escape(search_text) + r'\b')
    matches = pattern.findall(data)
    
    if not matches:
        print(f"错误：未找到 '{search_text}'")
        return
    
    new_data = pattern.sub(replace_text, data)
    with open(filepath, 'w', encoding='utf-8') as file:
        file.write(new_data)
    print(f"{search_text} 替换完成，共替换 {len(matches)} 处")

for item in texterror:
    search_text = item
    replace_text = f'"{search_text}"'
    dothereplace(search_text, replace_text)

说明：\b代表单词边界，此方案只会替换独立存在的目标词，不会替换被引号或其他字符包裹的相同内容，第二次运行时会正确提示未找到匹配项。

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