多gs文件的Google Apps Script库调用报错求助

先查最关键的两个点 #

• 库的部署版本和权限：库部署的时候得选Anyone, even anonymous（测试阶段用这个最方便），而且表格脚本里引用的必须是已保存的正式版本，不能用草稿版——草稿版的函数外部根本调用不到。
• 库函数的可见性：库里面的函数必须是全局能访问的，不能嵌套在其他函数里，也不能用局部变量定义。比如：

  // 正确写法
  function myLibFunc() {
    // 逻辑代码
  }
  
  // 错误写法（这种局部函数外部找不到）
  function someWrapper() {
    function myLibFunc() {}
  }
  

自定义菜单的正确用法 #

自定义菜单里不能直接写库函数路径，不管带不带括号都不行，必须先写个本地中转函数，再在菜单里调用这个本地函数，由它去调用库函数。示例代码：

function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('我的工具')
    .addItem('执行功能', 'triggerLibFunc')
    .addToUi();
}

// 本地中转函数
function triggerLibFunc() {
  // MyLib是你引入库时设置的别名，要和实际一致
  MyLib.myLibFunc();
}

其他排查方向 #

• 检查函数名冲突：库的多个gs文件里别出现同名函数，不然会导致调用混乱。
• 参数要匹配：调用库函数时，传入的参数数量、类型得和库函数定义的一致——GAS有时候报错不准，参数不匹配也可能提示“找不到函数”。
• 重新引入库：把表格脚本里的库引用删掉，重新添加一次，选对版本，避免缓存搞鬼。

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