Google Sheets onEdit脚本报错：无法读取undefined的range属性

报错核心原因 #

这个错误的本质是：onEdit作为Google Apps Script的简单触发器，只有在你手动编辑表格单元格时，系统才会自动传入事件对象e。如果直接在脚本编辑器里手动运行onEdit函数，e会是undefined，自然无法读取e.range。

此外原代码还有几个潜在风险：未校验事件对象、未排查目标工作表是否存在、未保护表头行。

修复后的完整代码 #

function onEdit(e) {
  // 拦截手动运行的情况，避免报错
  if (!e) {
    SpreadsheetApp.getUi().alert("请通过编辑表格单元格触发此函数，不要手动运行！");
    return;
  }

  const range = e.range;
  const sheet = range.getSheet();
  const value = e.value?.toLowerCase(); // 处理单元格清空时的undefined情况
  const row = range.getRow();
  const col = range.getColumn();
  const statusCol = 9; // 状态列对应第9列（I列）
  const ss = SpreadsheetApp.getActiveSpreadsheet();

  // May表 → Pending表逻辑
  if (sheet.getName() === "May" && col === statusCol && row > 1) {
    const pendingSheet = ss.getSheetByName("Pending");
    if (!pendingSheet) {
      SpreadsheetApp.getUi().alert("未找到名为'Pending'的工作表，请检查名称！");
      return;
    }
    if (value === "pending") {
      const rowValues = sheet.getRange(row, 1, 1, sheet.getLastColumn()).getValues()[0];
      pendingSheet.appendRow(rowValues);
      sheet.deleteRow(row);
    }
  }

  // Pending表 → May表逻辑
  if (sheet.getName() === "Pending" && col === statusCol && row > 1) {
    const maySheet = ss.getSheetByName("May");
    if (!maySheet) {
      SpreadsheetApp.getUi().alert("未找到名为'May'的工作表，请检查名称！");
      return;
    }
    if (value === "complete") {
      const rowValues = sheet.getRange(row, 1, 1, sheet.getLastColumn()).getValues()[0];
      maySheet.appendRow(rowValues);
      sheet.deleteRow(row);
    }
  }
}

关键修复点说明 #

1. 事件对象校验：开头判断!e时弹出提示，彻底解决手动运行的报错问题
2. 表头保护：添加row > 1判断，防止误改表头状态导致表头被移动
3. 工作表存在性检查：提前校验目标工作表是否存在，避免因表名错误或误删导致后续崩溃
4. 空值处理：用e.value?.toLowerCase()处理单元格清空的场景，避免value为undefined时的报错

使用注意事项 #

• 不要在脚本编辑器中手动运行onEdit，直接回到表格编辑状态列（第9列）的下拉框即可触发逻辑
• 确保工作表名称May和Pending完全匹配（大小写敏感，无多余空格）
• 如果状态列不是第9列，修改代码中statusCol的数值即可

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