Google Apps Script中appendRow()跨表使用及替代方法咨询

一、使用appendRow() 实现需求 #

1. 写入Sheet1 #

appendRow() 会自动在工作表的最后一行非空行的下一行追加数据，用法直接：

function appendToSheet1() {
  const targetData = ["示例数据"]; // 数组元素对应不同列，单列仅需一个元素
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet1 = ss.getSheetByName("Sheet1");
  
  // 追加数据到Sheet1末尾
  sheet1.appendRow(targetData);
}

2. 写入Sheet2并限定A10-A30范围 #

appendRow() 无法直接指定写入范围，需先判断Sheet2的A列已用行数，确保追加后的行落在A10-A30区间内：

function appendToSheet2WithLimit() {
  const targetData = ["示例数据"];
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet2 = ss.getSheetByName("Sheet2");
  
  // 获取A列已填充的有效行数
  const filledRows = sheet2.getRange("A:A").getValues().filter(String).length;
  const nextRow = filledRows + 1;
  
  // 检查是否在指定范围内
  if (nextRow >= 10 && nextRow <= 30) {
    sheet2.appendRow(targetData);
  } else {
    console.log("Sheet2的A列已超出10-30行范围，无法追加数据");
  }
}

合并两个操作的完整代码：

function appendToBothSheets() {
  const targetData = ["示例数据"];
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // 写入Sheet1
  const sheet1 = ss.getSheetByName("Sheet1");
  sheet1.appendRow(targetData);
  
  // 写入Sheet2（限定A10-A30）
  const sheet2 = ss.getSheetByName("Sheet2");
  const filledRows = sheet2.getRange("A:A").getValues().filter(String).length;
  const nextRow = filledRows + 1;
  
  if (nextRow >= 10 && nextRow <= 30) {
    sheet2.appendRow(targetData);
  } else {
    console.log("Sheet2的A列已超出10-30行范围，无法追加数据");
  }
}

二、appendRow() 之外的替代实现方式 #

1. setValues() 批量写入（推荐，性能更优） #

setValues() 支持一次性写入多行多列数据，适合批量操作，也能精确控制写入位置：

function setValuesToSheets() {
  const targetData = ["示例数据"]; // 单列数据，多列可扩展为["列1", "列2"]
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // 写入Sheet1末尾
  const sheet1 = ss.getSheetByName("Sheet1");
  const lastRowSheet1 = sheet1.getLastRow() + 1;
  sheet1.getRange(lastRowSheet1, 1, 1, targetData.length).setValues([targetData]);
  
  // 写入Sheet2的A10-A30区间（找第一个空行）
  const sheet2 = ss.getSheetByName("Sheet2");
  const range = sheet2.getRange("A10:A30");
  const values = range.getValues();
  let targetRow = -1;
  
  // 遍历查找A10-A30中的第一个空行
  for (let i = 0; i < values.length; i++) {
    if (!values[i][0]) {
      targetRow = 10 + i; // 转换为实际行号
      break;
    }
  }
  
  if (targetRow !== -1) {
    sheet2.getRange(targetRow, 1, 1, targetData.length).setValues([targetData]);
  } else {
    console.log("Sheet2的A10-A30已无空行");
  }
}

2. 直接使用setValue()写入指定行 #

如果仅写入单个单元格，setValue() 比setValues() 更简洁：

function directWriteToSheets() {
  const targetData = "示例数据";
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // 写入Sheet1末尾
  const sheet1 = ss.getSheetByName("Sheet1");
  sheet1.getRange(sheet1.getLastRow() + 1, 1).setValue(targetData);
  
  // 写入Sheet2的A10-A30区间
  const sheet2 = ss.getSheetByName("Sheet2");
  const filledRowsInRange = sheet2.getRange("A10:A30").getValues().filter(String).length;
  const targetRow = 10 + filledRowsInRange;
  
  if (targetRow <= 30) {
    sheet2.getRange(targetRow, 1).setValue(targetData);
  } else {
    console.log("Sheet2的A10-A30已满");
  }
}

3. 插入新行后写入（insertRowsBefore()） #

如果需要在指定位置插入新行再填充数据，可使用insertRowsBefore()：

function insertRowThenWrite() {
  const targetData = "示例数据";
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // 写入Sheet1
  const sheet1 = ss.getSheetByName("Sheet1");
  const lastRowSheet1 = sheet1.getLastRow() + 1;
  sheet1.insertRowsBefore(lastRowSheet1, 1);
  sheet1.getRange(lastRowSheet1, 1).setValue(targetData);
  
  // 写入Sheet2（限定范围）
  const sheet2 = ss.getSheetByName("Sheet2");
  const filledRows = sheet2.getRange("A:A").getValues().filter(String).length;
  const nextRow = filledRows + 1;
  
  if (nextRow >= 10 && nextRow <= 30) {
    sheet2.insertRowsBefore(nextRow, 1);
    sheet2.getRange(nextRow, 1).setValue(targetData);
  } else {
    console.log("Sheet2超出指定范围");
  }
}

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