Google Apps Script设置单元格背景报错：TypeError问题排查求助

核心错误点 #

• 范围选择错误：你使用的getRange(5, 3, 40)参数格式是(起始行, 起始列, 行数)，实际选中的是第5行第3列开始、向下延伸40行的单元格（行5至行44，仅列3），和你预期的「第5行第3列到第43列」不符。正确范围需用getRange(5, 3, 1, 40)，最后一个参数代表列数，即选中1行、40列。
• Range对象访问错误：range是Range实例，不能直接用range[i]获取单个单元格，这种写法会返回undefined，调用setBackground时自然触发「无法读取undefined属性」的错误。需通过range.getCell(rowOffset, colOffset)方法获取单个单元格（偏移量基于当前range的起始位置）。

修正后的代码 #

var range = sheetToChange.getRange(5, 3, 1, 40); // 修正为第5行、列3至43的范围
for(var i = 1; i <= 40; i++) { // 单元格偏移从1开始，对应range内的第1到40列
  var cell = range.getCell(1, i); // 因为是单行，行偏移固定为1
  var cellValue = cell.getValue();
  switch(cellValue) {
    case "7 star": 
      cell.setBackground('green'); 
      break;
    case "": 
      break;
    default: 
      cell.setBackground('red'); 
      break;
  }
}

更高效的批量处理方式（推荐） #

若数据量较大，逐个操作单元格效率偏低，建议先获取所有值，生成对应背景色数组后批量设置：

var range = sheetToChange.getRange(5, 3, 1, 40);
var values = range.getValues()[0]; // 提取第5行的所有值转为一维数组
var backgrounds = values.map(function(value) {
  if(value === "7 star") return 'green';
  if(value === "") return null; // 保留原有背景色
  return 'red';
});
range.setBackgrounds([backgrounds]); // 批量应用背景色

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