Word Online文本替换异常求助：{{test}}被重复处理致结果错误

看起来你的问题是异步操作并发执行导致的——三个替换任务同时启动，互相干扰了搜索和替换的结果。让我帮你分析下原因并给出解决方案：

问题原因 #

你在ProcessArray里用forEach遍历标签并调用异步的FillTag函数，但forEach并不会等待每个异步操作完成就会执行下一个迭代。这就导致三个Word.run会话几乎同时对文档进行操作：

• 当处理{test}的搜索时，它会匹配到原文本{{test}}中的{test}部分（因为此时{{test}}还没被替换成1）
• 随后{{test}}被替换成1，但之前匹配到的{test}位置已经被记录，于是这部分又被替换成3，最终变成了13

解决方案 #

方案1：修复异步遍历逻辑 #

把forEach换成for...of循环，这样可以确保每个替换操作完成后再执行下一个，避免并发干扰：

修正后的ProcessArray函数：

async function ProcessArray(myTags) {
  // 使用for...of确保异步操作按顺序执行
  for (const tag of myTags) {
    await FillTag(tag);
  }
}

方案2：优化为单次Word.run会话（更推荐） #

多次调用Word.run会增加上下文切换的开销，而且更容易出现并发问题。我们可以把所有替换逻辑放到一个Word.run会话中，按顺序处理每个标签：

完整优化代码：

Office.initialize = function(reason) {
  function ready() {
    var myTags = [
      { "value": "1", "text": "{{test}}" },
      { "value": "2", "text": "[[test]]" },
      { "value": "3", "text": "{test}" }
    ];

    async function FillAllTags() {
      await Word.run(async function(context) {
        const body = context.document.body;
        
        // 按顺序处理每个标签，处理完一个再处理下一个
        for (const tag of myTags) {
          const options = Word.SearchOptions.newObject(context);
          options.matchWildCards = false;
          const searchResults = body.search(tag.text, options);
          context.load(searchResults);
          await context.sync();
          
          // 替换当前标签的所有匹配项
          searchResults.items.forEach(item => {
            item.insertText(tag.value, Word.InsertLocation.replace);
          });
          await context.sync();
        }
      })
      .catch(function(error) {
        console.log('Error: ' + JSON.stringify(error));
        if (error instanceof OfficeExtension.Error) {
          console.log('Debug info: ' + JSON.stringify(error.debugInfo));
        }
      });
    }

    FillAllTags();
  }

  if (document.readyState !== 'loading') {
    ready();
  } else {
    document.addEventListener('DOMContentLoaded', ready);
  }
};

这个优化版本的好处：

1. 所有操作在一个Word上下文里完成，减少了不必要的同步开销
2. 严格按顺序处理标签，处理完{{test}}替换成1后，再处理{test}时，文档里已经没有{{test}}中的{test}部分了，只会匹配到单独的{test}
3. 每次替换后同步上下文，确保修改生效后再进行下一轮搜索

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