如何用getNextDataRange获取单个单元格地址并遍历提取数据

表格示例 #

问题场景 #

以单元格D1为起点调用getNextDataRange(SpreadsheetApp.Direction.NEXT)，得到的是D1:G1的整行范围，但需要拆分为单个单元格列表，再遍历每个单元格获取对应列的全部数据，最终生成类似Java List<String, Map>的结构。

实现代码 #

function getColumnDataList() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const startCell = sheet.getRange('D1');
  
  // 获取横向连续表头范围，拆分为单个单元格
  const headerRange = startCell.getNextDataRange(SpreadsheetApp.Direction.NEXT);
  const headerCells = headerRange.getCells();
  
  const resultList = [];
  
  // 遍历每个表头，获取对应列数据并构建Map结构
  headerCells.forEach(cell => {
    const columnDataRange = cell.getNextDataRange(SpreadsheetApp.Direction.DOWN);
    const columnValues = columnDataRange.getValues().flat();
    
    const dataMap = {
      [cell.getValue()]: columnValues
    };
    
    resultList.push(dataMap);
  });
  
  Logger.log(resultList);
  return resultList;
}

代码解析 #

1. 拆分横向范围：headerRange.getCells()会将D1:G1范围拆分为[D1, E1, F1, G1]四个独立的单元格对象，满足单个单元格列表的需求。
2. 获取列数据：对每个表头单元格调用getNextDataRange(SpreadsheetApp.Direction.DOWN)，自动定位该列从表头到最后一行的连续数据范围，getValues().flat()将二维数组转为一维数组，方便后续存储。
3. 构建目标格式：每个列数据封装为一个JS对象（对应Java的Map），键为表头文本，值为列数据数组，所有对象存入数组后，就得到了类似List<String, Map>的结构。

输出结果示例 #

运行代码后，resultList的结构如下：

[
  {"test1": ["test1", "test2", "test3", "test4", "test5"]},
  {"test6": ["test6", "test7", "test8", "test9", "test10"]},
  {"test11": ["test11", "test12", "test13", "test14", "test15"]},
  {"test16": ["test16", "test17", "test18", "test19", "test20"]}
]

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