已发布的Google Apps Script插件添加表格自定义函数失效的解决方法

核心原因 #

普通的@customfunction注释在Google Workspace插件中不会自动暴露给表格，因为插件的运行上下文和独立脚本/绑定脚本不同，必须通过**插件清单（manifest）**配合特定配置来声明自定义函数。

具体实现步骤 #

1. 配置插件清单（appsscript.json） #

修改appsscript.json文件，添加sheets扩展配置并声明自定义函数，确保清单信息和函数的JSDoc描述一致：

{
  "timeZone": "America/New_York",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "addOns": {
    "sheets": {
      "customFunctions": [
        {
          "functionName": "DOUBLE",
          "description": "Multiplies the input value by 2.",
          "parameters": [
            {
              "name": "input",
              "type": "NUMBER",
              "description": "The value to multiply."
            }
          ],
          "returnValue": {
            "type": "NUMBER",
            "description": "The input multiplied by 2."
          }
        }
      ]
    }
  }
}

2. 确保函数代码全局可访问 #

你的现有函数代码无需修改，但要保证函数是全局定义的（不要嵌套在其他函数内部）：

/**
 * Multiplies the input value by 2.
 *
 * @param {number} input The value to multiply.
 * @return The input multiplied by 2.
 * @customfunction
 */
function DOUBLE(input) {
  return input * 2;
}

3. 重新部署并启用插件 #

• 在Google Apps Script编辑器中，点击右上角部署 -> 选择测试部署或正式部署，部署类型选Google Workspace插件。
• 部署完成后，打开目标Google表格，点击扩展程序 -> 你的插件名称 -> 启用。

4. 调用自定义函数 #

在表格单元格中直接输入=DOUBLE(A1)（替换A1为目标单元格）即可使用。

常见排查点 #

• 确认插件已在当前表格中启用，未启用的插件其自定义函数不会被识别。
• 核对清单中的functionName和代码中的函数名完全一致（大小写敏感）。
• 检查插件权限是否正常，确保已授权插件访问表格数据。
• 清除浏览器缓存或用隐身模式测试，避免旧版本插件缓存干扰。

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