Google Sheets插件新文档菜单不显示，如何跳过「在本文档中使用」激活流程？

我太懂这个痛点了！当你把插件发布到私有应用市场后，新文档里菜单死活不出来，非得手动点「在本文档中使用」，本质就是Auth.Mode授权上下文的问题——新文档打开时插件默认是AuthMode.NONE，没有足够权限加载菜单或执行初始化逻辑。下面是我亲测有效的解决方案：

核心思路：用安装触发器绑定授权上下文 #

Google Workspace插件的onInstall函数是在AuthMode.FULL下运行的（用户授权后执行），我们可以利用这个时机创建一个可安装的打开触发器，这个触发器会带着用户的授权信息，在每次打开文档时自动执行初始化逻辑，直接跳过手动激活的步骤。

具体实现步骤 #

1. 编写安装触发器创建逻辑
   在你的Google Script代码中添加onInstall函数，它会在用户首次安装插件时创建一个可安装的onOpen触发器：

   function onInstall(e) {
     // 先执行一次初始化（确保安装后当前文档能看到菜单）
     initializeAddOn(e);
     // 创建可安装的打开触发器
     ScriptApp.newTrigger('initializeAddOn')
       .forSpreadsheet(SpreadsheetApp.getActiveSpreadsheet())
       .onOpen()
       .create();
   }
   

2. 编写通用的初始化函数
   把菜单创建逻辑放到单独的initializeAddOn函数里，兼容不同的AuthMode：

   function initializeAddOn(e) {
     const authMode = e.authMode;
     // 只有在授权模式下（LIMITED或FULL）才创建菜单
     if (authMode !== ScriptApp.AuthMode.NONE) {
       const ui = SpreadsheetApp.getUi();
       // 清除旧菜单（避免重复创建）
       ui.removeMenu('你的插件名称');
       // 创建新菜单
       ui.createMenu('你的插件名称')
         .addItem('打开侧边栏', 'showSidebar')
         .addToUi();
     }
   }
   

3. 保留原有的onOpen函数（可选但推荐）
   为了兼容手动触发的场景，保留基础的onOpen函数，当AuthMode允许时直接调用初始化逻辑：

   function onOpen(e) {
     initializeAddOn(e);
   }
   

关键注意事项 #

• 发布插件时配置权限：在插件发布设置中，确保勾选了「允许安装触发器」的相关权限（通常在OAuth范围里会包含https://www.googleapis.com/auth/script.scriptapp）。
• 测试时重新安装插件：修改代码后，要在测试账号里卸载再重新安装插件，确保触发器正确创建。
• 避免重复创建触发器：如果担心多次安装导致触发器重复，可以在onInstall里先检查已存在的触发器并删除，再创建新的。

这样一来，用户安装插件后，打开任何新的Google Sheets文档时，触发器会自动带着授权上下文运行initializeAddOn函数，菜单直接显示，完全不需要手动点「在本文档中使用」啦！

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