如何区分完整单词与子串进行Python字符串替换？

问题重现 #

示例代码：

dictionary = {"happy": 'YAY!', "happybday": "PARTY!"}

string = "There were so many happy people exclaiming happybday!"

for old_word, new_word in dictionary.items():
    string = string.replace(old_word, new_word)

print(string)

当前输出：

There were so many YAY! people exclaiming YAY!bday!

期望输出：

There were so many YAY! people exclaiming PARTY!!

问题原因 #

核心问题是str.replace()会替换所有匹配的子串，而字典的遍历顺序（Python 3.7+为插入顺序）先处理了短的"happy"，导致"happybday"中的"happy"被提前替换，长字符串"happybday"失去了匹配机会。这和in关键字无关，本质是子串优先匹配覆盖了更长的目标串。

解决方案 #

方案1：按字符串长度倒序遍历字典 #

将字典的键按长度从长到短排序，先处理更长的字符串，避免短串提前替换掉长串的部分内容。

代码实现：

dictionary = {"happy": 'YAY!', "happybday": "PARTY!"}
string = "There were so many happy people exclaiming happybday!"

# 按键的长度倒序排序，优先处理长字符串
for old_word, new_word in sorted(dictionary.items(), key=lambda x: -len(x[0])):
    string = string.replace(old_word, new_word)

print(string)

方案2：用正则匹配完整单词（更精准） #

如果需要确保只替换独立的完整单词（避免"happybday"里的"happy"被误匹配），可以用正则表达式的\b（单词边界）来匹配完整单词。

代码实现：

import re

dictionary = {"happy": 'YAY!', "happybday": "PARTY!"}
string = "There were so many happy people exclaiming happybday!"

# 构建正则模式，匹配所有字典中的键，添加单词边界确保完整匹配
pattern = re.compile(r'\b(' + '|'.join(re.escape(k) for k in dictionary.keys()) + r')\b')
# 用回调函数替换匹配到的内容
result = pattern.sub(lambda m: dictionary[m.group()], string)

print(result)

原理说明 #

• 方案1核心是优先级控制：长字符串匹配优先级高于短字符串，先替换长串就不会出现短串覆盖长串的情况。比如先把"happybday"替换为"PARTY!"，再替换剩余的"happy"为"YAY!"，完全避免冲突。
• 方案2核心是精准匹配：\b代表单词边界（如空格、标点、字符串首尾），确保只有独立的"happy"单词会被替换，"happybday"作为完整单词不会被拆分匹配，从根源上解决子串误匹配问题。如果需求是替换完整单词，这个方案更可靠。

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