AppScript 中 JavaScript 函数未定义的常见原因与修复方法

花韻仙語 2026-01-06 00:00:00 次阅读

在 google apps script 的 html 模态对话框中，因语法错误（如箭头函数书写不规范）导致 js 函数未被正确解析和定义，从而触发 “function not defined” 错误。本文详解定位与修复方案。

在 Apps Script 的客户端 HTML 环境中，JavaScript 代码必须被浏览器完整、无误地解析后，函数才能挂载到全局作用域并响应 onchange 或 onclick 事件。你遇到的 addRemoveCal is not defined 并非权限或作用域问题，而是HTML 解析提前中断所致——这通常由语法错误引发。

最典型的元凶是 TemplateSelectJS.html 中的这一行：

functionList.forEach(func = >google.script.run.func());

此处 = > 是非法语法（多了一个空格），浏览器将其识别为 func =（赋值表达式）后紧跟 >（大于号），立即抛出：

Uncaught SyntaxError: Unexpected token '>' (at userCodeAppPanel:20:33)

一旦发生此类解析错误，后续所有

✅ 正确写法（无空格的箭头函数）：

function runFunctionList() {
  functionList.forEach(func => google.script.run[func]());
  google.script.host.close();
}

⚠️ 注意事项：

google.script.run.func() 是错误写法：func 是函数引用（如 makeCalendar_），不能直接作为属性名调用；应使用方括号语法 google.script.run[func]() 或更安全的 google.script.run[func.name]()（需确保函数有名称）。
所有 Apps Script 服务端函数（如 makeCalendar_）必须声明为 public（即不加 private 修饰符），且位于 .gs 文件顶层。

推荐在 google.script.run 调用后添加错误处理：

google.script.run
  .withSuccessHandler(() => console.log('Executed:', func.name))
  .withFailureHandler(err => console.error('Failed:', func.name, err))
  [func.name]();

? 最佳实践建议：