为何setBackground()仅在首次循环迭代中生效？

问题重现 #

• 在Google Sheets中调用stylist函数，该函数通过调用colourer函数批量设置单元格背景色，但colourer内的setBackground仅在第一次循环迭代时生效，后续无动作。
• 将while循环直接移至stylist函数内调用setBackground，所有目标单元格均可正常着色，且已确认循环变量的输出值符合预期。

相关代码如下：

原stylist函数 #

function stylist()
{
  var sheet = SpreadsheetApp.getActiveSpreadsheet();
  var _catsheet = "Sheet1";
  var catsheet = sheet.getSheetByName(_catsheet);
  var lr = lastRowOfCol(1, _catsheet); // 获取指定列的最后一行，参数：列号、目标工作表
  var cur = lr; 
  var tar = lr +10;
  var colours = 
  ["#b4a7d6", "#d9d2e9", // 深紫、浅紫
  "#4dd0e1", "#4dd0e1", // 深青、浅青
  "#ffe599", "#fff2cc", // 深黄、浅黄
  "#fff2cc", "#9fc5e8"] // 深蓝、浅蓝
 
  colourer(cur, tar, 2, colours[2]);
}

原colourer函数 #

function colourer(cr, tr, col, c1)
{
  var sheet = SpreadsheetApp.getActiveSpreadsheet();
  var _catsheet = "Sheet1";
  var catsheet = sheet.getSheetByName(_catsheet);
  while(cr <= tr)
  {
    catsheet.getRange(cr, col).setBackground(c1);
    cr++;
  }
}

移至stylist内的可正常运行的循环代码 #

while(cur <= tar)
{
  catsheet.getRange(cur, 2).setBackground(colours[2]);
  cur++;
}

原因分析 #

核心问题在于Google Apps Script的服务调用机制：逐单元格循环调用getRange和setBackground这类服务方法时，本身就属于低效写法，且在子函数中多次调用这类方法，可能因上下文细微差异或服务批处理延迟，导致后续调用未被正确执行。此外，频繁的服务调用还容易触发Google Apps Script的执行时间或调用次数限制。

解决方法 #

方法1：优化为一次性范围设置（推荐） #

避免逐单元格循环操作，改为一次性获取目标单元格范围后统一设置背景色，大幅减少服务调用次数，同时解决执行异常问题。

修改后的colourer函数：

function colourer(cr, tr, col, c1) {
  var sheet = SpreadsheetApp.getActiveSpreadsheet();
  var catsheet = sheet.getSheetByName("Sheet1");
  // 获取从cr行到tr行、指定列的整列范围
  var targetRange = catsheet.getRange(cr, col, tr - cr + 1, 1);
  targetRange.setBackground(c1);
}

方法2：传递已获取的工作表对象 #

如果需要保留逐单元格循环的逻辑，可以将主函数中已获取的catsheet对象作为参数传入colourer，避免在子函数中重复获取工作表，消除上下文差异。

修改后的stylist函数调用部分：

// 传入已获取的catsheet对象
colourer(catsheet, cur, tar, 2, colours[2]);

修改后的colourer函数：

function colourer(catsheet, cr, tr, col, c1) {
  while(cr <= tr) {
    catsheet.getRange(cr, col).setBackground(c1);
    cr++;
  }
}

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