本文详解如何利用 openpyxl 的富文本（`cellrichtext`）功能，仅将单元格中匹配关键词列表的单词部分设为红色，保留其余文字为默认颜色，避免误匹配、重叠覆盖或遗漏多词场景。
在 excel 自动化处理中，常需对单元格内特定词汇（如变更项、敏感词、旧术语）进行精准高亮，而非整单元格染色。OpenPyXL 从 3.1 版本起正式支持富文本（CellRichText），允许对同一单元格内不同字符片段分别设置字体样式——但其 API 并不直接支持“查找替换式”高亮，需手动拆分字符串并构建 TextBlock 序列。
以下为完整、健壮的实现方案：
✅ 核心思路：按位置有序拼接富文本块
- 对每个非空单元格文本，用正则 re.finditer() 扫描所有 prev_list 中关键词的精确单词边界匹配（r’b{word}b’）；
- 收集所有匹配的 (start, end) 区间，并按起始位置升序排序（确保顺序处理）；
- 遍历这些区间，依次追加三类 TextBlock：
- 当前匹配前的未高亮文本（黑色）；
- 匹配词本身（红色）；
- 上一匹配结束后、下一匹配开始前的中间文本（黑色）；
- 处理完所有匹配后，补上末尾剩余文本。
✅ 完整可运行代码示例
from openpyxl import Workbook from openpyxl.cell.text import InlineFont from openpyxl.cell.rich_text import TextBlock, CellRichText import pandas as pd import re # 读取关键词列表（去重 + 转字符串） prev_words = pd.read_excel("prev_file.xlsx", usecols=['word']) prev_list = list(set(prev_words['word'].dropna().astype(str).tolist())) # 去重 & 过滤 NaN # 初始化工作簿与数据写入 wb = Workbook() ws = wb.active df = pd.read_excel("new_file.xlsx") for r in dataframe_to_rows(df, index=False, header=True): ws.append(r) # 定义字体样式 red_font = InlineFont(color='FF0000') # 红色（简写格式亦可，OpenPyXL 自动补全） black_font = InlineFont(color='000000') # 黑色 # 开始逐单元格处理（跳过表头行，min_row=2 → 第二行起） for row in ws.iter_rows(min_row=2): # 注意：Excel 行号从 1 开始，header 占第 1 行 for cell in row: if not cell.value: # 跳过空单元格，避免生成 "None" 字符串 continue text = str(cell.value) # 查找所有不重叠的单词边界匹配（使用 set 加速 & b 保证整词匹配） red_spans = [] for word in prev_list: if not word.strip(): # 跳过空白词 continue # 使用原始字符串防止转义问题，b 确保匹配独立单词（如 'cat' 不匹配 'category'） pattern = rf'b{re.escape(word)}b' for match in re.finditer(pattern, text, flags=re.IGNORECASE): # 忽略大小写更实用 red_spans.append((match.start(), match.end())) if not red_spans: # 无匹配则跳过处理 continue # 按起始位置排序，确保线性拼接正确 red_spans.sort(key=lambda x: x[0]) # 构建富文本对象 rich_text = CellRichText() prev_end = 0 # 上一个已处理区间的结束位置 for start, end in red_spans: # 添加 start 之前未处理的文本（黑色） if prev_end < start: rich_text.append(TextBlock(black_font, text[prev_end:start])) # 添加当前匹配词（红色） rich_text.append(TextBlock(red_font, text[start:end])) prev_end = end # 添加最后一段剩余文本（黑色） if prev_end < len(text): rich_text.append(TextBlock(black_font, text[prev_end:])) cell.value = rich_text wb.save("result_highlighted.xlsx") wb.close()⚠️ 关键注意事项
- 表头跳过逻辑：iter_rows(min_row=2) 是因 Excel 行号从 1 开始，且 dataframe_to_rows(…, header=True) 已将列名写入第 1 行。若存在多级表头，应改为 min_row=1 + df.columns.nlevels。
- 空值防护：显式检查 if not cell.value 可避免 None 被转为字符串 “None”，也防止对空单元格执行正则引发异常。
- 精确匹配保障：必须使用 b（单词边界）和 re.escape(word)（转义特殊字符如 +, *, ( 等），否则关键词含正则元字符时会报错或误匹配。
- 性能优化：{*prev_list} 在原答案中用于去重，但实际循环中建议提前去重（如代码所示），避免重复编译正则；对大文件，可预编译正则对象池。
- 大小写处理：添加 flags=re.IGNORECASE 更符合业务场景（如 “Cat” 和 “cat” 均需高亮），如需严格区分，移除此参数。
该方案彻底解决了原始代码中“仅高亮最后一个匹配词”的缺陷，支持单单元格内任意次数、任意顺序、非重叠的多关键词高亮，输出效果严格符合预期：
✅ I have a dog, a cat and a fish → I have a **dog**, a **cat** and a **fish**（仅关键词红，标点与空格保持原色）。