如何用Office.js开发Word插件实现指定子串替换并标记修订

要实现仅替换段落内特定子串并将修改部分标记为待审核的修订状态（Redline），核心是精准定位目标子串的范围，分别对删除旧内容、插入新内容的操作标记修订，而非整段替换。以下是具体实现方案：

核心思路 #

1. 定位目标段落并读取其文本内容
2. 查找目标子串在段落中的位置，生成精准的文本范围（Range）
3. 删除旧子串时标记为删除类型的修订
4. 在原位置插入新内容时标记为插入类型的修订

完整代码实现 #

await Word.run(async (context) => {
  // 配置参数：目标段落索引、待替换子串、替换后的新内容
  const paragraphIndex = 10;
  const oldSubstring = "play a crucial role";
  const newContent = "are pivotal";

  const targetPara = context.document.body.paragraphs.items[paragraphIndex];
  // 加载段落文本内容用于定位子串
  targetPara.load("text");
  await context.sync();

  // 查找子串起始位置，未找到则终止操作
  const startPos = targetPara.text.indexOf(oldSubstring);
  if (startPos === -1) {
    console.log("未找到目标子串");
    return;
  }

  // 创建对应旧子串的Range对象
  const oldRange = targetPara.getRange(Word.RangeLocation.start, startPos);
  oldRange.expandTo(startPos + oldSubstring.length);
  
  // 删除旧子串并标记为删除修订
  oldRange.delete(Word.DeleteOptions.delete, {
    trackChanges: true,
    revisionType: Word.RevisionType.delete
  });

  // 在原位置插入新内容并标记为插入修订
  oldRange.insertText(newContent, Word.InsertLocation.start, {
    trackChanges: true,
    revisionType: Word.RevisionType.insert
  });

  await context.sync();
});

关键细节说明 #

• 精准范围定位：通过getRange和expandTo方法锁定旧子串的准确位置，避免影响段落其他内容
• 修订标记控制：删除和插入操作均通过trackChanges: true开启修订跟踪，并指定对应revisionType，确保只有修改部分显示Redline
• 多子串处理扩展：若段落内存在多个相同子串，可通过循环调用indexOf（传入上一次结束位置作为起始参数）实现批量处理

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