Google Apps Script中如何从范围或getValues数组移除表头

offset(rowOffset, columnOffset) 只传入行列偏移参数时，会默认保持和原范围完全相同的高度、宽度，相当于整个范围向下平移1行，底部会多纳入1行原命名范围外的空白单元格，因此返回的数组尺寸和带表头时一致，末尾会多出对应空白行的空值元素。

方案1：指定offset的范围尺寸（性能最优） #

调用offset时补充传入高度、宽度参数，直接定位到跳过表头的精准数据范围，不会拉取多余单元格：

const idRange = SpreadsheetApp.getActive().getRangeByName('id');
// 参数依次为：行偏移1、列偏移0、范围高度=原行数-1、范围宽度=原列数
const idValues = idRange.offset(1, 0, idRange.getNumRows() - 1, idRange.getNumColumns()).getValues();

方案2：拉取全量数据后通过数组方法截取 #

不需要额外计算范围属性，代码更简洁，适合数据量不大的场景：

// 拿到全部值后从索引1开始截取，直接丢弃第1行表头
const idValues = SpreadsheetApp.getActive().getRangeByName('id').getValues().slice(1);

如果命名范围末尾存在无数据的空白行，可以追加过滤逻辑去掉整行空的无效条目：

const idValues = SpreadsheetApp.getActive().getRangeByName('id')
  .getValues()
  .slice(1)
  .filter(row => row.some(cell => cell !== null && cell !== ''));

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