如何在Word插件中跨Word.run上下文跟踪正则及多搜索Range？

问题a：使用正则匹配时跟踪搜索结果的Range #

你当前的batchsearch函数只是在字符串层面用JS的matchAll做匹配，没有关联到Word文档的实际Range对象，自然无法跟踪。要解决这个问题，需要为每个匹配项创建对应的Word Range，并加入跟踪列表：

修改后的batchsearch核心逻辑 #

let results = []; // 全局维护跟踪的Range列表

async function batchsearch() {
  const words = Object.keys(americanbody).join("|");
  // 清理之前的跟踪结果
  if (results.length > 0) {
    await Word.run(results, async (context) => {
      results.forEach(range => range.untrack());
      results = [];
      await context.sync();
    });
  }
  cleartable();

  await Word.run(async (context) => {
    var i = 0;
    const body = context.document.body;
    const paragraphs = body.paragraphs;
    paragraphs.load("text"); // 加载段落文本用于匹配
    await context.sync();

    const regex = new RegExp(`\\b(${words})\\b`, "ig"); // 转义反斜杠避免正则语法错误
    const batchSize = 100;
    let start = 0;

    while (start < paragraphs.items.length) {
      const end = Math.min(start + batchSize, paragraphs.items.length);
      const chunk = paragraphs.items.slice(start, end);
      
      for (const para of chunk) {
        let match;
        regex.lastIndex = 0; // 重置正则索引，避免循环中匹配异常
        while ((match = regex.exec(para.text)) !== null) {
          const typo = match[0];
          const correction = americanbody[typo];
          // 计算匹配项在段落中的起始/结束偏移量
          const matchStart = match.index;
          const matchEnd = match.index + typo.length;
          // 创建对应Word Range对象
          const matchRange = para.getRange(matchStart, matchEnd);
          matchRange.load("text");
          results.push(matchRange); // 加入跟踪列表
          i++;
          createtable(i, typo, correction);
        }
      }
      start += batchSize;
    }

    await context.sync();
    // 跟踪所有新生成的Range，确保跨上下文可用
    results.forEach(range => range.track());
  });
}

关键要点： #

• 不能仅依赖JS字符串匹配，必须通过para.getRange()将文本匹配位置映射为Word文档的实际Range对象
• 每个创建的Range都要加入全局results列表，并在上下文同步后调用track()
• 正则循环匹配时需重置lastIndex，避免因全局正则特性导致的匹配跳过问题

问题b：多轮搜索中持续跟踪结果 #

多轮搜索的核心是严格管理跟踪状态的生命周期：

1. 新搜索前清理旧跟踪：

   • 每次启动新搜索前，在Word.run(results, ...)上下文内对所有旧Range执行untrack()，并清空results数组
   • 必须执行await context.sync()确保清理操作生效，避免内存泄漏

2. 新搜索的Range跟踪流程：

   • 在新的Word.run上下文内创建所有匹配的Range对象，加载必要属性
   • 同步上下文后统一调用track()，确保这些Range能跨上下文被选中、修改
   • 始终通过全局results列表维护跟踪对象，不要在上下文间传递未跟踪的Range

3. 跨上下文操作注意事项：

   • 后续对Range的操作（如修改字体颜色），必须在Word.run(results, ...)上下文内执行，确保权限和引用有效
   • 若用户切换搜索关键词，重复执行「清理旧跟踪→生成新Range→跟踪新Range」的流程即可

补充说明 #

• 不要混用JS字符串匹配和Word API的Range操作：JS匹配仅能提供文本位置，只有通过Word API生成的Range才能被跟踪和操作
• 批量处理段落时，可根据文档大小调整batchSize，平衡性能和内存占用

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