如何在Google Apps Script中替代forEach函数实现邮件发送？

我用Google Sheet做等待列表，想每周自动发送更新邮件告知用户当前的等待排名。作为Apps Script和编程新手，我参考了2022年的同类解决方案代码，但其中的forEach函数似乎失效了。以下是原帖代码和我调整后的代码，求最优替代方案：

原帖参考代码 #

function newmatchEmail() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet1=ss.getSheetByName('Active Student List');
var data=sheet1.getDataRange().getValues();

data.forEach(function(row,col){
if (col == '') return;
if (row[0] == '') return; //If ColA is empty skip
if (row [6] == false) return; //Skip if the checkbox is not checked in Col G
if (row [5] == 'YES') return; //Skip if the email has been sent in ColF

var info = row[0];
var name = row[2];
var studentemail = row[3];

var tutoremail = row[4];
var subject = "Student Opening Request";
var message = "Thank You So Much\n\nHere is the basic info: " + `${info}` 
 + "\nStudent Name: " + `${name}`
 + "\nStudent Email: " + `${studentemail}`
 + "\n\nPlease do not hesitate to ask questions";

MailApp.sendEmail(tutoremail, subject, message);

data.getRange(col + 1, 6).setValue('YES'); //Imprint YES in ColF once the email has been sent

data.getRange('G2:G').setValue(false); //Reset the checkboxes in ColG to null after emails/process is completed
});
}

我调整后的代码 #

function newmatchEmail() {
 var ss = SpreadsheetApp.getActiveSpreadsheet();
 var sheet1=ss.getSheetByName('Extension or Waitlist Form');
 var data=sheet1.getDataRange().getValues();

data.forEach(function(row,col){
if (col == '') return;
if (row[0] == '') return; 
if (row [3] == 'NO') return; 

var info = row[0];
var name = row[1];

var email = row[2];
var subject = "Waitlist Update";
var message = "Hello" + `${name}` 
+ "You are currently number " + `${info}` + "on the waitlist for an appointment.";

MailApp.sendEmail(email, subject, message);
});
}

问题分析 #

原代码和你的调整版存在几个核心问题：

1. forEach参数理解错误：data.forEach(function(row, col)里的第二个参数是数组的行索引（从0开始），不是列。你误把它当成列来判断，逻辑完全错误。
2. 数组无法调用表格方法：data是getValues()返回的二维数组，不是Sheet或Range对象，原代码里data.getRange()会直接报错，这也是你觉得forEach失效的原因。
3. 无错误处理与效率问题：循环内直接操作表格单元格，容易触发Google服务的频次限制，且没有捕获邮件发送失败的情况。

最优替代代码 #

function sendWaitlistUpdates() {
  // 获取当前表格和目标工作表
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName('Extension or Waitlist Form');
  if (!sheet) {
    SpreadsheetApp.getUi().alert('未找到指定的工作表！');
    return;
  }

  // 获取全部数据（假设第1行是表头）
  const data = sheet.getDataRange().getValues();
  const startRow = 2; // 从第2行开始处理实际数据

  // 记录需要更新的行号，用于批量修改
  const updatedRows = [];

  // 遍历每一行数据
  data.forEach((row, index) => {
    // 跳过表头行和空行
    if (index < startRow - 1) return;
    if (!row[0]) return; // A列（排名）为空则跳过
    if (row[3] === 'NO') return; // D列标记为NO则跳过

    const rank = row[0];
    const name = row[1];
    const email = row[2];

    // 邮箱为空直接跳过，避免报错
    if (!email) {
      console.log(`第${index+1}行邮箱为空，跳过处理`);
      return;
    }

    // 构造邮件内容
    const subject = '预约等待列表更新通知';
    const message = `你好${name}：\n\n你目前在预约等待列表中排名第${rank}位。\n\n感谢你的耐心等待！`;

    try {
      // 发送邮件
      MailApp.sendEmail(email, subject, message);
      // 记录需要标记为已发送的行号
      updatedRows.push(index + 1);
    } catch (error) {
      console.error(`给${email}发送邮件失败：${error.message}`);
    }
  });

  // 批量更新已发送标记（D列设为YES）
  if (updatedRows.length > 0) {
    updatedRows.forEach(rowNum => {
      sheet.getRange(rowNum, 4).setValue('YES');
    });
  }

  // 弹出提示告知处理结果
  SpreadsheetApp.getUi().alert(`等待列表更新邮件已发送，共处理${updatedRows.length}条有效记录`);
}

核心改进说明 #

• 修正forEach逻辑：正确使用行索引，区分数组索引和实际表格行号
• 批量操作表格：先收集需要更新的行，最后统一修改，大幅提升效率并避免服务限制
• 增加边界检查：判断工作表是否存在、邮箱是否为空，减少不必要的报错
• 错误捕获机制：用try-catch处理邮件发送失败的情况，保证程序能继续执行
• 代码可读性优化：使用const定义常量，变量名更直观，逻辑清晰

设置每周自动触发 #

1. 打开Apps Script编辑器，点击左侧的「触发器」图标
2. 点击「添加触发器」，按以下设置：
   • 选择函数：sendWaitlistUpdates
   • 部署类型：「时间驱动」
   • 时间触发类型：「周计时器」
   • 设置你想要的每周发送时间
3. 保存后，脚本就会每周自动执行

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