使用Google Apps Script在谷歌表格创建自定义菜单时遇getUi()报错

核心原因 #

SpreadsheetApp.getUi() 只能在用户与谷歌表格直接交互的上下文中调用，出现这个错误通常是触发onOpen的方式不符合要求：

常见触发错误场景及解决 #

• 直接在脚本编辑器运行onOpen函数

  脚本编辑器里手动运行时，没有关联表格的UI环境，调用getUi()会报错。解决方法：关闭当前谷歌表格，重新打开，系统会自动执行onOpen生成自定义菜单。

• 使用非手动触发的触发器调用onOpen

  比如设置了时间驱动触发器、表单提交触发器来执行onOpen，这类触发器属于后台运行，没有UI上下文，无法调用getUi()。解决方法：删除这类错误的触发器，仅依赖表格打开时的自动触发。

• 脚本不是绑定到谷歌表格的绑定脚本

  如果你的脚本是独立创建的（不是通过表格菜单「扩展>Apps脚本」打开创建的），这类独立脚本没有关联的表格UI，无法调用getUi()。解决方法：删除独立脚本，通过目标表格的「扩展>Apps脚本」入口创建并编写代码。

额外注意事项 #

确保代码中引用的menuItem1和menuItem2函数已经定义，不然菜单点击后会报错，示例如下：

function menuItem1() {
  SpreadsheetApp.getUi().alert('第一个菜单被点击');
}

function menuItem2() {
  SpreadsheetApp.getUi().alert('子菜单被点击');
}

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