Google表格脚本报错：TypeError: Cannot read properties of undefined (reading 'range')

错误原因 #

你遇到的TypeError: Cannot read properties of undefined (reading 'range')，核心原因是手动在脚本编辑器里直接运行了onEdit函数。onEdit是Google Apps Script的简单触发函数，只有用户在表格中编辑单元格时，系统才会自动传入事件对象e；手动运行时e为undefined，读取e.range自然会报错。

解决方法 #

1. 正确触发函数：不要手动运行onEdit，直接回到目标表格，在"28th Mangsir"工作表中编辑第2列（任务列）的单元格（行号需大于1），函数会自动触发并填入邮箱。
2. 添加安全判断（可选）：修改代码增加对e对象的校验，避免手动运行时报错，同时不影响正常触发逻辑。

修正后的代码 #

function onEdit(e) {
  // 校验事件对象，防止手动运行报错
  if (!e || !e.range) return;
  
  const range = e.range;
  const rowIndex = range.getRow();
  const colIndex = range.getColumn();
  const sheet = range.getSheet();
  const SHEET_NAME = "28th Mangsir"; // 目标工作表名称
  const EMAIL_COLUMN = 4; // 邮箱填入列索引
  const TASK_COLUMN = 2; // 触发编辑的列索引
  
  if (colIndex === TASK_COLUMN && rowIndex > 1 && sheet.getName() === SHEET_NAME) {
    const userEmail = Session.getActiveUser().getEmail();
    sheet.getRange(rowIndex, EMAIL_COLUMN).setValue(userEmail);
  }
}

额外注意事项 #

• Session.getActiveUser().getEmail()仅在用户登录Google账号、且表格与账号权限匹配时有效，匿名用户或权限不足时会返回空值。
• 确保工作表名称"28th Mangsir"与实际表格名称完全一致（包括大小写）。

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