电子表格单元格遍历代码运行缓慢，求优化方案

我需要遍历电子表格的多个单元格，当单元格满足特定条件时，修改其背景色和文本内容。但现在的问题是，当找到多个符合条件的单元格时，运行速度特别慢——因为代码是逐个手动更新单元格的。另外，由于区域内有部分单元格被预留作其他用途，没法直接更新整个区域。以下是我写的代码，请问怎么优化才能提升运行速度？

["File1","File2","File3"].forEach(function(sheet) {
   spreadsheet.setActiveSheet(spreadsheet.getSheetByName(sheet), true);
    for(i=10;i<99;i++) {
      let cell = spreadsheet.getRange("J"+i);
      if (cell.getBackground() == "#00ff00") {
        cell.setBackground('#ea4335')
        cell.clearContent();
      } else if(cell.getBackground() == "#ea4335" && cell.getValue().toString().length > 0) {
        cell.clearContent();
      }
    }
});

优化思路 #

核心问题是原代码频繁调用Google Sheets API（每次循环都执行getRange、getBackground、getValue等操作），API交互是脚本性能瓶颈，优化方向是批量读写，减少API调用次数：

• 一次性读取目标区域（J10到J98）的所有背景色和单元格值，在内存中完成条件判断，避免逐单元格读取
• 直接操作工作表对象，无需切换激活状态
• 收集所有需要修改的内容和背景色，一次性批量写入，替代逐单元格更新

优化后的代码 #

const sheetNames = ["File1","File2","File3"];
const startRow = 10;
const endRow = 98;
const col = 10; // J列对应索引10

sheetNames.forEach(sheetName => {
  const sheet = spreadsheet.getSheetByName(sheetName);
  if (!sheet) return; // 防止工作表不存在报错
  
  // 一次性读取目标区域的背景色和值
  const range = sheet.getRange(startRow, col, endRow - startRow + 1, 1);
  const backgrounds = range.getBackgrounds();
  const values = range.getValues();
  
  // 准备要更新的背景色数组和内容数组
  const newBackgrounds = [...backgrounds];
  const newValues = [...values];
  
  // 内存中遍历判断，记录需要修改的项
  for (let i = 0; i < backgrounds.length; i++) {
    const bg = backgrounds[i][0];
    const value = values[i][0];
    
    if (bg === "#00ff00") {
      newBackgrounds[i][0] = "#ea4335";
      newValues[i][0] = ""; // 清空内容
    } else if (bg === "#ea4335" && value.toString().length > 0) {
      newValues[i][0] = ""; // 清空内容
    }
  }
  
  // 批量写入修改后的背景色和内容
  range.setBackgrounds(newBackgrounds);
  range.setValues(newValues);
});

优化效果说明 #

• 原代码每个工作表需要执行约90次API读取+若干次写入操作，优化后每个工作表仅需3次API读取（getRange、getBackgrounds、getValues）+2次写入（setBackgrounds、setValues），API调用次数大幅减少
• 内存中处理判断逻辑，速度远快于反复和Google Sheets服务器交互
• 保留了原逻辑的所有判断条件，同时避免了不必要的激活工作表操作

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