优化Google Script循环：解决批量邮件脚本运行缓慢及超时问题

嘿，我完全懂你这种被频繁调用电子表格拖慢脚本甚至报错的痛苦！之前我也处理过类似的批量个性化邮件发送脚本，给你几个亲测有效的优化思路，尤其是你提到的缓存和减少API调用这块：

Google Apps Script里，每一次调用SpreadsheetApp的方法（比如getRange()、getValue()）都是一次API请求，在循环里反复调用的话，速度会慢得离谱，还容易触发API配额限制。

正确的做法是把用户列表和数据表的所有数据一次性读取到内存里，变成二维数组，之后的所有操作都在内存里完成：

// 一次性获取用户列表的全部数据
const userSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('用户列表');
const userData = userSheet.getDataRange().getValues();

// 一次性获取数据表的全部数据
const dataSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('数据表');
const allData = dataSheet.getDataRange().getValues();

这样后续遍历用户和匹配数据时，完全不用再碰电子表格API，速度会直接起飞。

你提到的“遍历个人列表，再遍历数据表”是典型的O(n*m)嵌套循环，数据量一大就会卡死。我们可以把数据表转换成键值对对象（比如用用户ID作为键），这样查找用户对应数据的时间复杂度直接降到O(1)：

// 把数据表转换成以用户ID为键的映射对象
const dataMap = {};
allData.forEach(row => {
  const userId = row[0]; // 假设数据表第一列是用户ID，可根据实际调整
  dataMap[userId] = row;
});

// 遍历用户列表时，直接通过ID快速获取对应数据
userData.forEach(userRow => {
  const userId = userRow[0];
  const userSpecificData = dataMap[userId];
  
  // 这里处理个性化邮件内容...
});

这一步优化对大数量级的数据来说，性能提升是数量级别的。

如果你的场景里存在多个用户需要复用同一段数据的情况，CacheService就能派上用场，避免重复遍历数组：

const cache = CacheService.getScriptCache();

// 封装一个带缓存的查询函数
function getCachedUserData(userId) {
  // 先查缓存
  const cachedResult = cache.get(userId);
  if (cachedResult) {
    return JSON.parse(cachedResult);
  }
  
  // 缓存没命中，从映射对象里取（或者数组里找）
  const result = dataMap[userId];
  if (result) {
    // 把结果缓存起来，设置过期时间（比如1小时，单位秒）
    cache.put(userId, JSON.stringify(result), 3600);
  }
  
  return result;
}

不过如果已经用了上面的键值对映射，其实缓存的必要性就没那么高了，但如果是更复杂的查询逻辑，缓存还是能帮上忙。

• 提前准备好邮件模板：用HtmlService.createTemplateFromFile()预加载HTML模板，循环里只替换变量，避免每次都重新构建模板内容。
• 尽量简化MailApp.sendEmail()的参数：不要在循环里重复创建复杂的对象，比如提前定义好邮件的通用主题、附件（如果有的话），只替换个性化内容。

确保你的脚本已经切换到V8运行时，它比旧的Rhino引擎快好几倍。在脚本编辑器的「运行」菜单里找到「启用新的Apps Script运行时（V8）」，开启后性能会有明显提升。

如果用户数量实在太多，超过了Google Apps Script的6分钟运行限制，可以把用户分成批次，用时间驱动触发器分批执行。比如每次处理50个用户，处理完后触发下一批的执行，这样就不会因为超时报错。

总结一下，最核心的优化是一次性拉取所有数据到内存和用键值对替换嵌套循环，这两个操作能解决90%的速度问题，缓存属于锦上添花的优化，适合特定场景。

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