GAS脚本跨表复制单元格区域时额外多出2行空白行的问题

问题表现 #

• 业务流程：用户在「New Items」工作表录入新产品信息，采购审核通过后从菜单运行脚本，将数据同步到「Price Book」价格簿工作表，同步完成后清空「New Items」表的录入内容
• 异常现象：有效数据可正常写入目标表，但每次执行都会额外新增2行空白行，手动核查两个工作表均未发现预置空行

原问题代码：

function addNewItems() {
  //Get new item data from New Items Sheet
  var ss = SpreadsheetApp.getActive();
  var s = ss.getSheetByName("New Items");
  s.activate();

  //define non-contiguous data ranges from source sheet fpr clearing after copying
  var newInput1 = ss.getRange("New Items!A2:K");
  var newInput2 = ss.getRange("New Items!N2:O");
  var newInput3 = ss.getRange("New Items!Q2:R");
 
  // Get last row of data from source sheet
  lastR = s.getLastRow();
  // Select range of data with new item information (17 is the last column of data)
  var newItems = s.getRange(2,1,lastR,17).getValues();
  
  //Switch to target sheet to add new records into Price Book
  var ts = ss.getSheetByName("Price Book");
  ts.activate();
  
  //Find last row of Price Book data and add one to get next row
  tsIns = ts.getLastRow();

  //Start at the next row and insert the data range from the New Item sheet
  var newInsert = ts.getRange(tsIns +1,1,lastR,17).setValues(newItems);
  

  //Clear data from new item sheets after copying data to the Price Book
  newInput1.clearContent();
  newInput2.clearContent();
  newInput3.clearContent();

}

根因分析 #

问题由两个逻辑错误共同导致：

1. 行数计算错误：getRange(起始行, 起始列, 行数, 列数)的第三个参数是需要读取的总行数，不是结束行号。源表第1行是表头，有效数据从第2行开始，到lastR行结束，实际有效行数应为lastR - 1。代码直接传入lastR作为行数，会从第2行开始多读取1行空内容。
2. 源表清空逻辑缺陷：
   • 清空范围只覆盖了A-K、N-O、Q-R列，中间的L、M、P列残留的空格、格式标记、旧数据不会被清除，getLastRow()会将这些残留内容的行号算入，导致lastR取值比实际有效录入行偏大
   • 定义清空范围时使用了A2:K这类未指定结束行的A1写法，GAS会默认选中从起始行到工作表最大行的整段范围，执行clearContent()后会错误扩展工作表的已使用范围，进一步导致getLastRow()取值偏大

两个问题叠加后，最终读取的数据源会多带2行空值，写入目标表就会出现固定2行空白行的问题。

修复后代码 #

修复点：

• 移除不必要的activate()调用，脚本读写不需要激活工作表，减少异常触发概率
• 修正行数计算逻辑，读取和写入数据时统一使用有效数据行数，避免多取空行
• 调整清空逻辑，直接清空有效数据行的全部17列内容，避免列遗漏和无边界范围导致的已使用范围异常
• 增加空数据判断，无录入内容时直接终止执行，避免误操作

function addNewItems() {
  var ss = SpreadsheetApp.getActive();
  var sourceSheet = ss.getSheetByName("New Items");
  var targetSheet = ss.getSheetByName("Price Book");

  // 获取源表最后一行，计算有效数据行数（减去第1行表头）
  const sourceLastRow = sourceSheet.getLastRow();
  const dataRowCount = sourceLastRow - 1;
  // 无新数据时直接终止执行
  if (dataRowCount < 1) return;

  // 读取源表有效数据（从第2行开始，共dataRowCount行，17列）
  const newItems = sourceSheet.getRange(2, 1, dataRowCount, 17).getValues();

  // 写入目标表，从目标表现有最后一行的下一行开始写入
  const targetLastRow = targetSheet.getLastRow();
  targetSheet.getRange(targetLastRow + 1, 1, dataRowCount, 17).setValues(newItems);

  // 清空源表录入内容：直接清空第2行到最后一行的全部17列，无列遗漏
  sourceSheet.getRange(2, 1, dataRowCount, 17).clearContent();
}

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