如何在Google Sheets App Script的forEach循环中设置单元格值

问题梳理 #

• 现有脚本运行时仅会打印符合条件行的日志，无写入操作
• 需要将原代码中Logger.log的日志逻辑替换为单元格赋值逻辑，给SA列非空、DI列为空的行设置DI列的值
• 原代码仅读取了表格数据到内存数组做判断，没有做值修改和写回表格的操作

实现方案 #

优先推荐批量写入方案，性能远高于循环内单次调用setValue，避免数据量大时脚本执行超时：

function add(){
  var mainsname ='MIIST';
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var mainss = ss.getSheetByName(mainsname);
  var adcnumber = ss.getRangeByName('AD').getColumn();
  var sacnumber = ss.getRangeByName('SA').getColumn();
  var dicnumber = ss.getRangeByName('DI').getColumn();
  var range = mainss.getDataRange();
  // 读取全量数据到内存数组，不提前跳过表头，方便后续统一写回
  var data = range.getValues();
  // 从第2行开始遍历，跳过表头行（数组索引从0开始，所以遍历起始位为1）
  for(let i = 1; i < data.length; i++){
    const row = data[i];
    // 匹配SA列非空、DI列为空的目标行
    if(row[sacnumber - 1] !== "" && row[dicnumber - 1] === ""){
      // 将下方赋值内容替换为你实际需要写入DI列的值即可，例如要写同行AD列值就填 row[adcnumber - 1]
      data[i][dicnumber - 1] = '需要写入的目标值';
    }
  }
  // 一次性将修改后的全量数据写回表格
  range.setValues(data);
}

如果确实需要使用setValue单条写入（仅适合数据量极小的场景），需要注意计算准确的行号，写法如下：

function add(){
  var mainsname ='MIIST';
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var mainss = ss.getSheetByName(mainsname);
  var adcnumber = ss.getRangeByName('AD').getColumn();
  var sacnumber = ss.getRangeByName('SA').getColumn();
  var dicnumber = ss.getRangeByName('DI').getColumn();
  var range = mainss.getDataRange();
  var data = range.getValues().slice(1);
  data.forEach((row, idx)=>{
    if(row[sacnumber-1] !== "" && row[dicnumber-1] === "" ){
      // idx为截断表头后的数组索引，对应表格实际行号为 idx + 2
      mainss.getRange(idx + 2, dicnumber).setValue('需要写入的目标值');
    }
  })
}

注意事项 #

• 代码中'需要写入的目标值'占位符请替换为实际业务需要写入DI列的内容，支持固定值、同行其他列的取值、计算表达式等
• 批量写入方案仅需调用两次表格API（读、写各一次），执行效率是循环单条写入的数十倍，能有效规避Apps Script的执行时长限制

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