Google Sheets自定义函数无法显示，运行触发参数校验报错求助

一、编辑器点击Run触发参数错误的原因 #

自定义函数是为Google Sheets单元格调用设计的，参数默认由单元格区域（如A1:A5）传入并自动转换为数组。但在AppScript编辑器直接点击Run时，没有传入任何参数，此时actionTimeArray为undefined，你的参数校验逻辑Array.isArray(actionTimeArray)会判定不通过，直接抛出错误。

二、自定义函数不在表格显示的常见原因 #

1. 缺少@customfunction标签的JSDoc注释：Google Sheets依赖该标签识别自定义函数，无此标签则不会在函数列表中显示。
2. 函数嵌套在其他函数内部：自定义函数必须定义在脚本顶级作用域，不能嵌套在其他函数中。
3. 脚本未保存或表格未刷新：修改脚本后需保存，再刷新表格页面才能加载新函数。
4. 权限未完成授权：首次使用自定义函数时，需完成Google权限授权，否则函数无法正常加载。

三、具体解决办法 #

解决编辑器Run报错的问题 #

不要直接Run自定义函数，改用以下方式测试：

• 在表格单元格中调用：比如输入=combo_totalTime(A1:A3)（替换为实际数据区域），直接在表格内测试。
• 编写测试函数：在AppScript编辑器中写专门的测试函数，手动传入模拟数组参数，示例：

function testComboFunctions() {
  // 模拟表格传入的数组参数
  const mockActionTimes = [0.5, 1.2, 0.8];
  const mockDamages = [200, 350, 180];
  
  // 调用自定义函数并打印结果到日志
  console.log("总时长：", combo_totalTime(mockActionTimes));
  console.log("总伤害：", combo_totalDamage(mockDamages));
  console.log("总DPS：", combo_totalDPS(mockActionTimes, mockDamages));
}

点击Run这个测试函数，即可正常触发自定义函数逻辑，同时避免参数为空的错误。

解决函数不在表格显示的问题 #

给每个自定义函数添加标准JSDoc注释（必须包含@customfunction），示例：

/**
 * 计算连招总时长
 * @param {number[]} actionTimeArray 每个动作的时长数组（对应表格单元格区域）
 * @param {number} [superDuration] 超级持续时间（可选参数）
 * @returns {number} 连招总时长
 * @customfunction
 */
function combo_totalTime(actionTimeArray, superDuration) {
  // 参数校验逻辑
  if (!Array.isArray(actionTimeArray)) {
    throw new Error("actionTimeArray must be an array");
  }
  // 你的计算逻辑...
  return actionTimeArray.reduce((sum, time) => sum + time, 0);
}

完成后：

1. 点击AppScript编辑器的保存按钮（💾）。
2. 刷新Google Sheets页面。
3. 若弹出授权提示，按步骤完成授权。

之后就能在表格的函数列表里找到你的自定义函数了。

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