本文介绍如何利用 pandas 的 `str.replace()` 配合正则表达式，精准地将 excel 文本列中出现的编号（如 123、345）按映射表批量替换成对应人名（如 john、marshall），支持多处匹配与单词边界保护。
在实际数据处理中，常需将自由文本中嵌入的标识符（如员工编号、产品 ID）替换为更具可读性的描述（如姓名、名称）。直接使用 .map() 仅适用于整字段精确匹配，而原始需求是在句子中局部查找并替换子串——这正是 str.replace() 结合正则表达式的典型应用场景。
以下是完整、健壮的实现方案：
import pandas as pd
import re
# 1. 读取数据
df_articles = pd.read_excel('Articles.xlsx')
df_macros = pd.read_excel('macros.xlsx')
# 2. 构建 ID → Description 映射 Series（确保 ID 转为字符串，避免类型不匹配）
mapping_series = df_macros.astype({'ID': str}).set_index('ID')['Description']
# 3. 构造带单词边界的正则模式：\b(123|345|678)\b
# \b 确保只匹配独立单词，避免 '1234' 中误替换 '123'
pattern = r'\b(' + '|'.join(re.escape(str(id_val)) for id_val in mapping_series.index) + r')\b'
# 4. 执行安全替换：对 Content_Text 列逐句匹配并替换
df_articles['Content_Text'] = df_articles['Content_Text'].str.replace(
pattern,
lambda match: mapping_series.get(match.group(0), match.group(0)), # 未命中时保留原文
regex=True
)
# 5. 保存结果
df_articles.to_excel('updated_Articles.xlsx', index=False)✅ 关键要点说明：
- re.escape()：自动转义 ID 中可能出现的正则元字符（如 .、*、+），提升鲁棒性；
- \b 单词边界：防止 123 错误匹配 1234 或 abc123def（后者不含边界，不匹配）；
- lambda match：动态查表，确保大小写/格式严格一致；
- .get(..., match.group(0))：对未定义 ID 保持原文，避免静默丢弃或报错。
⚠️ 注意事项：
- 若 ID 列含空值或非字符串类型（如浮点数 123.0），务必先用 astype(str).str.rstrip('.0') 清洗；
- 大量 ID 时，正则模式长度受限（Python 默认上限约 10k 字符），超限时建议分批处理或改用 apply() + 自定义函数；
- 如需区分大小写匹配，str.replace(..., case=True, regex=True) 可显式控制（默认即区分）。
该方法兼顾准确性、可维护性与性能，是处理“文本内符号化占位符替换”任务的标准实践。
