Google Apps Script触发器函数调试：局部变量未定义问题

问题根源 #

调试显示的所有变量未定义，本质是事件对象e未正确传递：代码执行到if (e.changeType == "INSERT_GRID")时，因e为undefined抛出Cannot read properties of undefined (reading 'changeType')错误，函数直接中断，后续的sheetNames、sheets、i等变量根本没机会被声明赋值，所以显示为undefined。

常见触发场景：

• 触发器类型错误：使用了onEdit、时间驱动等非onChange类型的触发器，这类触发器不会传递包含changeType属性的事件对象
• 手动运行函数：直接在脚本编辑器点击运行，此时无事件对象传入，e自然为undefined

修复方案 #

1. 修正代码逻辑（增加错误防御+优化写法） #

function changeSheet(e) {
  // 无事件对象时直接退出，避免报错
  if (!e) {
    console.log("请通过onChange触发器运行此函数");
    return;
  }

  // 仅处理插入工作表的事件
  if (e.changeType !== "INSERT_GRID") {
    return;
  }

  // 定义允许保留的工作表名称
  const sheetNames = ["Principal", "Lunes", "Martes", "Miércoles", "Jueves", "Viernes", "Lunes_blanco", "Martes_blanco", "Miércoles_blanco", "Jueves_blanco", "Viernes_blanco", "DATOS", "Automata"];
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheets = ss.getSheets();

  // 工作表数量不符时，清理多余表
  if (sheets.length !== sheetNames.length) {
    sheets.forEach(sheet => {
      if (!sheetNames.includes(sheet.getName())) {
        ss.deleteSheet(sheet);
      }
    });
  }
}

2. 配置正确的触发器 #

必须创建**onChange类型触发器**，步骤如下：

• 打开Google表格的脚本编辑器
• 点击左侧时钟图标进入「触发器」页面
• 点击「添加触发器」，配置以下选项：
  • 选择函数：changeSheet
  • 部署类型：Head deployments
  • 事件源：从电子表格
  • 事件类型：更改
• 保存并完成权限授权

关键说明 #

• 原代码中变量未定义并非变量声明问题，而是函数执行被提前中断，后续代码根本没运行
• onChange触发器是唯一能捕获INSERT_GRID（插入工作表）事件的触发器类型，其他触发器无法触发该逻辑

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