Google Sheets插件仅显示Help按钮，主页卡片不加载求助

针对你遇到的问题，以下是几个经过验证的解决方向：

1. 清理缓存并重新授权插件 #

• 关闭当前Sheets文档，用无痕模式打开浏览器（或清除浏览器缓存）
• 重新进入Sheets，到「Extensions > 已安装的插件」找到你的应用，点击「管理」后选择「删除」
• 再次通过「Extensions > Get Add-ons」安装内部应用，安装完成后打开插件，确保完整完成授权流程

2. 移除清单中冗余的homepageTrigger配置 #

你同时在addOns.common和addOns.sheets下配置了homepageTrigger，可能引发逻辑冲突。建议保留针对Sheets的配置，移除通用配置中的触发项，修改后的清单如下：

{
   "timeZone": "America/Chicago",
   "runtimeVersion": "V8",
   "oauthScopes": [
     "https://www.googleapis.com/auth/spreadsheets.currentonly"
   ],
   "addOns": {
     "common": {
       "name": "Test Add-On",
       "logoUrl": "https://www.gstatic.com/images/icons/material/system/1x/extension_48dp.png"
     },
     "sheets": {
       "homepageTrigger": {
         "runFunction": "onHomepage"
       },
       "onFileScopeGrantedTrigger": {
         "runFunction": "onHomepage"
       }
     }
   }
 }

修改后重新部署到Marketplace SDK，确保版本更新生效。

3. 调整卡片返回逻辑 #

尝试将直接返回卡片改为返回导航指令，明确推送卡片到侧边栏，替换原onHomepage代码：

function onHomepage() {
  console.log("🚀 onHomepage() was triggered!");
  const card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle("Loaded"))
    .addSection(CardService.newCardSection()
      .addWidget(CardService.newTextParagraph().setText("This add-on works ✅")))
    .build();
  return CardService.newNavigation().pushCard(card);
}

4. 检查Marketplace SDK发布配置 #

• 登录Marketplace SDK控制台，确认应用「发布状态」为「内部可用」，且目标组织正确
• 核对「应用详情」中「Google Sheets」的关联配置，确保绑定的Apps Script项目ID无误
• 重新发布应用，强制同步最新的代码和清单配置

5. 测试开发版本验证问题 #

在Apps Script编辑器中，选择「部署 > 测试部署」，创建Add-on测试版本，直接在Sheets中测试开发环境的插件。如果开发版本能正常显示卡片，说明问题源于Marketplace发布后的缓存或配置同步延迟，等待一段时间或重新发布即可。

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