Google Apps Script JS：SKU排序数组插入分组空行时生成异常三维数组

安全阿岳

2026-11-6

问题根因

你当前生成三维数组的核心原因是数组嵌套层级错误，具体问题点：

代码中orderSort.filter(...)返回的结果本身是二维结构（每个元素对应表格里的一行）
直接执行finalArr.push(element)时，会把整组同SKU的行块作为finalArr的单个元素，导致原本应该是「二维行集合」的最终数组，多套了一层SKU分组的外层结构，形成三维数组，无法直接用于表格写回
原代码用双重循环遍历去重、多轮全量过滤同SKU数据的逻辑性能冗余较高，数据量较大时会明显拖慢运行速度

优化实现方案

核心改造逻辑：

利用数据已经按SKU排序的前提，单次遍历行集，检测到SKU和上一行不一致时插入对应列数的空行即可，无需重复遍历全量数据
逐行将数据推入最终数组，避免整组块直接push带来的多余嵌套

优化后的完整代码：

function update(){
  const mfgSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Order Info");
  const purchaseLog = SpreadsheetApp
    .openById("1KkR4jE1c00WuQpPrexW8f9BIq5vxl0fWaUGxbeYERsE")
    .getSheetByName("Order Details");

  // 拉取原始数据，完成排序、无效行过滤、列映射
  const orderSort = purchaseLog
    .getRange(3, 1, purchaseLog.getLastRow(), 15)
    .getValues()
    // 按SKU列排序，兼容不同类型值的对比
    .sort((r1, r2) => {
      const a = r1[1]?.toString().trim() || '';
      const b = r2[1]?.toString().trim() || '';
      return a.localeCompare(b);
    })
    // 过滤SKU为空、SKU为表头的无效行
    .filter(item => {
      const sku = item[1]?.toString().trim();
      return sku !== '' && sku !== 'Purchase Order Link';
    })
    // 映射为需要的9列业务数据
    .map(r => [r[0], r[1], r[2], r[5], r[6], r[11], r[13], r[12], r[8]]);

  const finalArr = [];
  let lastRecordedSku = null;
  // 生成和业务数据列数完全匹配的空行，避免写回时列错位
  const blankSeparateRow = Array(9).fill('');

  // 单次遍历完成SKU分组检测、空行插入
  orderSort.forEach((currentRow, rowIndex) => {
    const currentRowSku = currentRow[1];
    // 非首行位置检测到SKU切换，先插入空行
    if(rowIndex !== 0 && currentRowSku !== lastRecordedSku) {
      finalArr.push(blankSeparateRow);
    }
    // 逐行推入数组，始终保持二维结构
    finalArr.push(currentRow);
    lastRecordedSku = currentRowSku;
  });

  Logger.log(finalArr);
  // 写回目标表示例（取消注释即可使用）
  // mfgSheet.getRange(1, 1, finalArr.length, finalArr[0].length).setValues(finalArr);
}

改造效果说明

最终生成的finalArr是标准二维结构，每一个元素对应表格中的一行数据，可直接调用setValues()写回，不存在多余嵌套
运行效率提升：原逻辑时间复杂度为O(n*m)（n为数据总行数，m为SKU去重列表长度），改造后为单次遍历的O(n)，数据量越大性能优势越明显
鲁棒性增强：排序、过滤环节增加了空值兼容、值类型转换处理，避免数字型SKU、带空格SKU的对比、排序出错；空行列数和业务列数完全对齐，不会出现表格错位
空行插入位置准确：只在相邻两行SKU不一致的位置插入，不会在第一行、最后一行末尾多余插入空行

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