如何优化Google Spreadsheet自定义函数的执行耗时？

核心性能问题 #

原代码的性能瓶颈完全来自重复调用Google Sheets服务端API：

循环内逐行调用getRange()、getValue()查询单元格值，还反复调用getLastRow()，每次这类调用都需要和表格服务端交互，单次开销就有几十毫秒，700行累计下来自然会超过2分钟超时限制。

优化思路 #

所有数据批量读取到内存后再做匹配，全程只调用1次表格API拉取数据，纯内存遍历匹配效率提升上百倍。

优化后代码 #

function findAgentRow() {
  // 提前计算目标列号，仅执行一次findColumn
  const agentColumn = findColumn(sheet, "Agent");
  // 一次性获取Agent列从第2行到最后一行的所有值，仅调用1次API
  const lastRow = sheet.getLastRow();
  const emailValues = sheet.getRange(2, agentColumn, lastRow - 1, 1).getValues();
  
  // 纯内存遍历匹配，无任何API调用
  for (let i = 0; i < emailValues.length; i++) {
    if (emailValues[i][0] === agentEmail) {
      // 数组索引从0开始，对应表格行号是i+2（因为从第2行开始读）
      return i + 2;
    }
  }
  // 没找到返回0
  return 0;
}

额外优化建议（可选） #

• 如果Agent列的表头不会频繁变动，可以把列号结果缓存起来，避免每次执行findColumn扫描表头
• 如果匹配逻辑固定，也可以直接用表格内置函数MATCH(agentEmail, 目标列范围, 0)，不需要自定义函数，性能更高

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