谷歌表格自定义函数：提取单元格区域首个单词问题排查

问题根源 #

• getValues() 返回的是二维数组，比如你选中的B1:I1区域会返回类似 [["Apple Pie", "Banana Bread", ...]] 的结构——外层是行数组，内层是每行的单元格值数组。
• 原代码直接对二维数组调用map，此时每个迭代项是子数组（比如["Apple Pie"]），而非字符串，调用split()自然会失效。

修正后的代码 #

/**
* 提取单元格区域中每个单元格的首个单词
* @customfunction
* @param {Range} range 要处理的单元格区域
* @return {Array} 每个单元格的首个单词组成的二维数组
*/
function GETFIRSTWORD(range) {
  // 遍历每一行，再逐个处理单元格
  return range.map(row => {
    return row.map(cell => {
      // 处理空单元格或非字符串值
      if (typeof cell !== 'string' || cell.trim() === '') {
        return '';
      }
      // 处理首尾空格+按任意数量空格分割，取首个单词
      return cell.trim().split(/\s+/)[0];
    });
  });
}

使用方法 #

在谷歌表格单元格中直接输入公式即可：

=GETFIRSTWORD(B1:I1)

函数支持多行多列区域，会保持原区域的行列结构返回结果。

细节优化说明 #

• 用trim()清理单元格首尾空格，避免因单元格前后空格导致提取错误。
• 用split(/\s+/)匹配任意数量的连续空格，兼容单元格内多个空格分隔的情况。
• 增加空值和非字符串判断，防止函数因无效输入报错。

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