如何调试由Google Sheet触发的Google Apps Script并查看日志

日志查看方法 #

• 替换旧的Logger.log()，改用console.log()输出调试信息。执行自定义菜单、onEdit()这类触发函数后，回到脚本编辑器，点击顶部菜单「查看」→「日志」即可查看实时输出，它支持字符串、对象等多种数据类型，比Logger更高效。
• 注意：默认的onEdit()属于简单触发器，无权访问需要授权的服务（比如调用外部API、修改其他文档），如果代码包含这类操作会直接静默失败，此时日志会明确显示授权错误提示，别忽略这个关键点。

触发函数的调试技巧 #

• 模拟触发上下文：如果函数依赖触发时的event对象（比如onEdit()需要e.range、e.value），可以手动构造模拟参数来调试，不用真的去编辑表格。示例代码：

  // 模拟onEdit的测试函数
  function testOnEdit() {
    const mockEvent = {
      range: SpreadsheetApp.getActiveSheet().getRange("A1"),
      value: "测试编辑值",
      oldValue: "原始值"
      // 根据你的代码需求添加其他event属性
    };
    // 直接调用目标函数
    onEdit(mockEvent);
  }
  

  写完后在脚本编辑器选中testOnEdit，点击运行按钮就能启动单步调试，查看变量和执行流程。
• 手动触发安装式触发器：如果使用的是自行创建的安装式触发器，可在「编辑」→「当前项目的触发器」里找到对应触发器，点击右侧三点菜单选择「运行现在」，直接触发函数并在日志里查看输出。

强制捕获错误信息 #

触发类函数静默失败时，最有效的排查手段是添加try-catch块捕获错误，甚至直接提示给用户：

function customMenuTrigger() {
  try {
    // 你的业务逻辑代码
    console.log("执行到步骤X，当前数据：", SpreadsheetApp.getActiveRange().getValue());
    // ...
  } catch (err) {
    // 输出错误详情到日志
    console.error("函数执行失败：", err.message, err.stack);
    // 弹窗提示用户（仅自定义菜单/安装式触发器可用，简单触发器不行）
    SpreadsheetApp.getUi().alert(`出错了：${err.message}`);
    // 也可以把错误写到表格的隐藏单元格，方便后续排查
    SpreadsheetApp.getActiveSheet().getRange("AA1").setValue(`错误栈：${err.stack}`);
  }
}

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