独立Google Apps Script无法为表格添加自定义菜单问题排查

核心原因 #

独立Apps Script项目通过测试部署作为表格附加组件时，onOpen函数的触发逻辑和绑定脚本完全不同：绑定脚本会在表格打开时自动执行onOpen，但独立附加组件需要用户主动启用授权，且首次安装需通过onInstall初始化菜单。

解决方案 #

方案1：改用绑定脚本（最简便直接）

直接在目标表格内创建绑定脚本：

1. 打开目标表格，点击菜单栏「扩展程序」→「Apps Script」
2. 删除默认代码，粘贴你的onOpen函数代码
3. 保存项目，刷新表格，自定义菜单会立即显示

方案2：保留独立脚本（作为附加组件）

如果必须使用独立项目，需调整代码并完成附加组件激活：

1. 添加onInstall函数：附加组件首次安装时会触发该函数，用于初始化菜单，同时调用onOpen确保后续打开表格时菜单正常显示：

   function onInstall(e) {
     onOpen(e);
   }
   
   function onOpen(e) {
     SpreadsheetApp.getUi()
       .createMenu('Test Menu')
       .addItem('foo', 'bar')
       .addToUi();
   
     SpreadsheetApp.getActiveSpreadsheet()
       .addMenu('Test Menu 2', [{ name: 'foo', functionName: 'bar' }]);
   }
   
   // 确保bar函数存在（否则菜单点击会报错）
   function bar() {
     SpreadsheetApp.getUi().alert('菜单触发成功');
   }
   

2. 重新部署测试版本并激活附加组件：
   • 回到独立脚本项目，点击「Deploy」→「Test deployments」→ 编辑现有测试部署，确保配置正确
   • 打开关联的表格，点击右上角「附加组件」，找到你的测试部署项目，点击「启用」并完成授权
3. 检查权限配置：
   • 打开appscript.json文件（点击编辑器右上角「设置」→「显示appsscript.json清单文件」）
   • 添加必要的OAuth权限，确保包含表格操作权限：

     {
       "timeZone": "Asia/Shanghai", // 替换为你的时区
       "dependencies": {},
       "exceptionLogging": "STACKDRIVER",
       "runtimeVersion": "V8",
       "oauthScopes": [
         "https://www.googleapis.com/auth/spreadsheets"
       ]
     }
     

4. 刷新表格，自定义菜单即可显示

关键说明 #

• 测试部署的「关联文件」仅允许附加组件作用于该文件，但不会自动触发onOpen，必须用户主动激活附加组件
• 绑定脚本无需部署，属于表格的一部分，打开表格时会自动执行onOpen，是添加自定义菜单的最优选择

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