使用Office Scripts批量替换多工作表值的性能优化咨询

当前你提供的Office Scripts脚本运行耗时45秒，核心问题出在冗余的循环和重复的Excel API调用上，以下是具体优化思路：

原代码问题分析 #

原代码存在的关键性能瓶颈：

• 嵌套遍历行和单元格时，每次都对整个UsedRange执行三次replaceAll，这是完全冗余的——replaceAll本身就是全局操作，执行一次就能覆盖所有目标内容，不需要循环每个单元格重复执行。
• 频繁调用Excel API（每次replaceAll都是一次API交互），跨内存与Excel的交互是Office Scripts的主要耗时点。

优化方案 #

1. 移除冗余嵌套循环，简化全局替换 #

直接在每个工作表的UsedRange上执行一次三个目标值的替换，完全去掉无意义的行和单元格遍历：

function main(workbook: ExcelScript.Workbook) {
  try {
    const sheets = workbook.getWorksheets();
    for (let sheet of sheets) {
      const usedRange = sheet.getUsedRange(true);
      // 每个工作表仅执行三次全局替换，无需遍历单元格
      usedRange.replaceAll("Pass", "", { completeMatch: true });
      usedRange.replaceAll("Fail", "", { completeMatch: true });
      usedRange.replaceAll("Skip", "", { completeMatch: true });
    }
  } catch (e) {
    console.error(e);
  }
}

2. 内存中批量处理后一次性写入 #

将数据读取到内存数组中完成所有替换逻辑，再一次性写回工作表，大幅减少Excel API交互次数（仅两次：getValues和setValues），这种方式性能提升更显著：

function main(workbook: ExcelScript.Workbook) {
  try {
    const sheets = workbook.getWorksheets();
    const targetStrings = ["Pass", "Fail", "Skip"];
    for (let sheet of sheets) {
      const usedRange = sheet.getUsedRange(true);
      if (!usedRange) continue; // 跳过无数据的工作表
      
      // 将数据读取到内存数组
      const values = usedRange.getValues() as string[][];
      
      // 在内存中完成替换
      for (let rowIndex = 0; rowIndex < values.length; rowIndex++) {
        const row = values[rowIndex];
        for (let colIndex = 0; colIndex < row.length; colIndex++) {
          if (targetStrings.includes(row[colIndex])) {
            row[colIndex] = "";
          }
        }
      }
      
      // 一次性将处理后的数据写回工作表
      usedRange.setValues(values);
    }
  } catch (e) {
    console.error(e);
  }
}

优化效果说明 #

• 第一种方案直接砍掉了99%的冗余API调用，性能会有质的提升；
• 第二种方案通过内存操作进一步减少交互次数，适合数据量较大的场景，耗时会压缩到几秒甚至更短。

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