Google Sheets中如何用GAS实现不定长二维数组的指定格式批量写入

原代码无法运行主要是5个硬伤导致的：

• 二维数组定义语法错误：现有写法的子数组边界完全错位，生成的是长度为1的非预期结构，根本不是存储逐行人员信息的二维数组，运行时直接触发类型报错
• forEach回调参数错配：回调函数第一个参数是当前遍历的元素值，第二个参数才是遍历索引，代码中把元素值当成数组下标访问，无法正确读取数组内容
• 数组下标越界、字段错配：原始单条记录包含4个元素（姓名、星级、职位、公司），对应下标范围0-3，代码中存在访问不存在的下标4、把职位字段当成星级内容写入的逻辑错误
• 写入逻辑不符合API规范：固定取起始单元格后，在循环内反复往同一个位置调用setValues，既无法实现逐行下移，同时setValues要求传入与选中范围完全匹配的二维数组，直接传字符串会触发类型报错
• 写入性能极差：逐行单格调用接口写入的方式，会产生大量跨服务请求，数组长度稍大就会触发Apps Script的执行时长配额限制

不需要在循环中逐格调用写入接口，核心思路是先把最终要输出的内容整理成和表格布局完全匹配的二维数组，再根据数组本身的实际行列长度动态计算写入范围，一次性完成全量写入。无论采集的二维数组长度是1条还是1000条，都不需要手动调整写入范围。

可直接运行的代码 #

function testArray() {
  const activeSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const activeSheet = activeSpreadsheet.getActiveSheet();
  // 写入起始参数：从第5行、第3列（C列）开始放置内容
  const startRow = 5;
  const startCol = 3;

  // 采集得到的原始二维数组（和数据库返回的结构保持一致，长度动态变化）
  const collectedData = [
    ["John Buck", "*****", "Associate", "Luxura"],
    ["Jane Doe", "****", "Manager", "Eclipse"],
    ["Jim Bob", "***", "Executive", "lokia"],
    ["Suzzy Sue", "*****", "Director", "RoomX"]
  ];

  // 提前整理成符合输出格式的二维数组：每行对应表格的两个单元格
  const writePayload = collectedData.map(record => {
    const starRating = record[1]; // 取星级内容
    const formattedText = `${record[0]}, ${record[2]}, ${record[3]}`; // 拼接人员信息
    return [starRating, formattedText];
  });

  // 动态计算写入范围：行数自动匹配整理后的数组长度，列数固定为2
  const targetRange = activeSheet.getRange(
    startRow,
    startCol,
    writePayload.length,
    writePayload[0].length
  );
  // 一次性全量写入
  targetRange.setValues(writePayload);
}

效果说明 #

• 完全适配动态数组长度：writePayload.length会自动读取当前采集到的记录条数，不管后续采集的记录是增加还是减少，都不需要修改范围参数
• 写入效率大幅提升：全量整理完数据后仅调用1次写入接口，运行速度远快于逐格写入，不会触发执行时长限制
• 可灵活调整字段映射：如果后续数据库返回的字段顺序变化，只需要修改map方法内取数组下标的位置即可，不需要调整核心写入逻辑

输出效果和要求的格式完全匹配：C列逐行展示星级字符串，D列逐行展示拼接后的人员信息，从第5行开始向下排列。

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