向自定义函数传入单元格区域时执行失败

错误原因 #

当Google Sheets自定义函数接收单元格区域参数时，传入的是二维数组：

• 若选中单列（如A1:A3），参数格式为[["文本1"], ["文本2"], ["文本3"]]
• 若选中单行（如A1:C1），参数格式为[["文本1", "文本2", "文本3"]]

你的代码直接遍历这个二维数组，每个str实际是子数组（比如["文本1"]）而非字符串，自然会触发str.split is not a function错误。

修正后的代码 #

/**
* 提取单元格区域中每个单元格的首个单词
* @customfunction
*/
function getFirstWord(alt_activities_range) {
  // 将二维数组扁平化，兼容单行/单列/多行多列的输入
  const flatArray = alt_activities_range.flat();
  
  // 遍历处理每个单元格值
  return flatArray.map(cellValue => {
    // 处理空单元格、非字符串值的边界情况
    if (typeof cellValue !== 'string' || cellValue.trim() === '') {
      return '';
    }
    // 去除首尾空格后，按任意数量空格分割取首个单词
    return cellValue.trim().split(/\s+/)[0];
  });
}

关键优化点 #

1. 使用flat()将二维数组转为一维，统一处理各种区域输入
2. 增加类型判断和空值处理，避免异常场景报错
3. 用正则/\s+/分割，兼容单元格内多个连续空格的情况
4. 重命名函数为更具语义的getFirstWord

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