如何高效将嵌套JS对象数组转为Google Sheets批量更新二维数组

针对你需要将嵌套对象数组转换为适合Google Sheets batchUpdate的二维数组需求，这里提供一个高效、简洁的实现方案，利用JavaScript内置方法替代手动嵌套循环，提升处理效率：

核心思路 #

1. 收集唯一键路径：遍历所有对象，提取扁平化的键路径（如a、b_x），通过集合自动去重。
2. 初始化结果映射：以键路径为键，创建对应长度的空数组，默认填充空字符串（对应无值的场景）。
3. 填充对象值：遍历每个对象，将对应键路径的值填充到映射数组的对应索引位置。
4. 转换为二维数组：将映射结构转换为符合要求的行数组，添加表头后直接适配表格格式。

实现代码 #

function convertNestedObjectsToSheetArray(objArray) {
  // 1. 收集所有唯一键路径
  const allKeyPaths = new Set();
  objArray.forEach(obj => {
    const traverse = (current, prefix = '') => {
      Object.entries(current).forEach(([key, value]) => {
        const fullPath = prefix ? `${prefix}_${key}` : key;
        if (typeof value === 'object' && value !== null) {
          traverse(value, fullPath);
        } else {
          allKeyPaths.add(fullPath);
        }
      });
    };
    traverse(obj);
  });

  // 2. 初始化结果映射，每个键路径对应空数组
  const resultMap = {};
  allKeyPaths.forEach(path => {
    resultMap[path] = new Array(objArray.length).fill('');
  });

  // 3. 填充每个对象的对应值到映射中
  objArray.forEach((obj, index) => {
    const traverse = (current, prefix = '') => {
      Object.entries(current).forEach(([key, value]) => {
        const fullPath = prefix ? `${prefix}_${key}` : key;
        if (typeof value === 'object' && value !== null) {
          traverse(value, fullPath);
        } else {
          if (resultMap[fullPath]) {
            resultMap[fullPath][index] = value;
          }
        }
      });
    };
    traverse(obj);
  });

  // 4. 转换为带表头的二维数组
  const header = ['Key_subkey', ...objArray.map((_, i) => `Object ${i+1} values`)];
  const rows = [...allKeyPaths].map(path => [path, ...resultMap[path]]);
  return [header, ...rows];
}

// 测试输入
const inputData = [
  {
    a: "val1",
    b: { x: "val2", y: "val3", z: "val4" },
    c: { s: "val5", t: "val6", r: "val7" }
  },
  {
    a: "val8",
    b: { x: "val9", z: "val10" },
    c: { t: "val11", r: "val12" }
  },
  {
    a: "val13",
    b: { y: "val14" },
    c: { s: "val15", t: "val16", z: "val17" }
  }
];

// 生成适配表格的二维数组
const sheetArray = convertNestedObjectsToSheetArray(inputData);

代码说明 #

• 键路径去重：通过递归遍历嵌套对象，用Set自动过滤重复的键路径，确保每行对应唯一的键组合。
• 无值场景处理：初始化时用空字符串填充所有位置，避免出现undefined或null导致表格显示异常。
• 高效遍历：使用Object.entries替代手动for...in循环，结合内置数组方法提升处理速度，适合大数量对象的场景。

Google Apps Script集成示例 #

生成的二维数组可直接用于表格批量更新：

function updateSpreadsheet() {
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('目标工作表');
  const sheetArray = convertNestedObjectsToSheetArray(inputData);
  
  // 批量写入表格
  targetSheet.getRange(1, 1, sheetArray.length, sheetArray[0].length).setValues(sheetArray);
}

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