如何用Google Apps Script逐行将数组数据写入表格区域（含条件判断）

嘿，我来帮你搞定这个Google Sheets脚本的问题！既然你已经通过.getValues()拿到了源表格的多维数组sheetValues，下面就给你详细讲怎么带条件地逐行写入目标表格：

核心工具方法 #

要实现这个需求，你主要会用到两个关键方法：

• targetSheet.getRange()：精准定位目标表格的写入区域，需要指定起始行、起始列、行数、列数四个参数
• setValues()：一次性将单行数据写入指定区域（注意它接受的是二维数组，所以单行要包成[rowArray]的形式）

完整代码示例（带条件判断） #

function writeFilteredRowsToTarget() {
  // 1. 先获取源表格和目标表格的对象
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName("源表格"); // 替换成你的源表格名称
  const targetSheet = ss.getSheetByName("目标表格"); // 替换成你的目标表格名称
  
  // 2. 你已经拿到的多维数组（这里也可以直接用你已有的sheetValues）
  const sheetValues = sourceSheet.getDataRange().getValues();
  
  // 3. 设置目标表格的起始写入行（比如跳过表头，从第2行开始）
  let nextTargetRow = 2;
  
  // 4. 遍历源数组的每一行，做条件判断后写入
  for (const row of sheetValues) {
    // 这里写你的自定义条件，举个例子：判断第1列非空且第3列值为"完成"
    if (row[0] !== "" && row[2] === "完成") {
      // 定位要写入的区域：从nextTargetRow行第1列开始，1行，当前行的列数
      const writeRange = targetSheet.getRange(nextTargetRow, 1, 1, row.length);
      // 写入当前行（必须包成二维数组，因为setValues只接受二维数组）
      writeRange.setValues([row]);
      
      // 写完一行后，目标行号+1，准备写下一行
      nextTargetRow++;
    }
  }
}

关键细节提醒 #

• 效率优先：尽量用setValues()而不是逐单元格用setValue()，前者批量写入的速度快很多，数据量大的时候差异特别明显
• 索引对应关系：数组的索引是从0开始的，但Google Sheets的行列是从1开始的，所以row[0]对应源表格的第一列数据，别搞混了
• 清空目标数据（可选）：如果每次写入前需要清空目标表格的旧数据，可以在循环前加这段代码：

  // 清空目标表格除表头外的所有内容（表头在第1行）
  const lastTargetRow = targetSheet.getLastRow();
  if (lastTargetRow > 1) {
    targetSheet.getRange(2, 1, lastTargetRow - 1, targetSheet.getLastColumn()).clearContent();
  }
  

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