Google Sheets自定义函数无法返回红色单元格值问题排查

原代码错误分析 #

1. 参数类型不匹配：调用GetHex(cell)时传入的是单元格值（如日期/文本），但getRange()需要的是范围引用（如"A2"），导致抛出"Invalid argument: range"异常。
2. Range对象遍历错误：直接用range.length获取行数无效——range是SpreadsheetApp的Range对象，不是数组，需先通过getValues()和getBackgrounds()转换为可遍历的二维数组。
3. 返回值逻辑错误：原代码中cell.getValues()是错误调用（cell是单元格值而非Range对象），且找到第一个红色单元格就终止遍历，无法收集同一行所有红色单元格的值。

修正后的代码 #

function GetColoredCellValue(inputRange) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const range = ss.getRange(inputRange);
  // 获取单元格值数组与对应背景色数组
  const values = range.getValues();
  const backgrounds = range.getBackgrounds();
  
  const redCellValues = [];
  // 遍历目标范围的每一行
  for (let row = 0; row < values.length; row++) {
    // 遍历当前行的每一列
    for (let col = 0; col < values[row].length; col++) {
      // 检查背景色是否为红色（#ff0000）
      if (backgrounds[row][col] === "#ff0000") {
        redCellValues.push(values[row][col]);
      }
    }
  }
  
  // 返回用逗号分隔的红色单元格值，无红色单元格则返回空字符串
  return redCellValues.length > 0 ? redCellValues.join(", ") : "";
}

代码说明 #

• 移除了冗余的GetHex()函数，直接在主函数内获取背景色，简化逻辑。
• getValues()和getBackgrounds()返回与目标范围行列对应的二维数组，确保单元格值和背景色一一对应。
• 收集所有红色背景单元格的值，最后用逗号拼接成字符串返回，适配单行多列的提取需求。

使用方法 #

在需要展示结果的单元格中输入公式：

=GetColoredCellValue(A2:HF2)

按回车即可得到该行所有红色背景单元格的值，多个值将以逗号分隔显示。

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