如何优化Google Apps Script中非同行数据范围的读取与赋值代码？

问题分析 #

你的现有代码通过多次单独读取每行数据并分位置写入，存在重复API调用、效率低下的问题。尝试getRangeList时数据变字符串，是因为未正确处理其返回的三维数组；直接读取E12:G15矩阵后转置，是混淆了「转置」和「扁平化」的需求——你需要的是将多行数据拼接为单行，而非行列互换。

优化方案：批量读取+扁平化数据+单次写入 #

核心思路是减少读写操作次数（Google Apps Script的API调用次数直接影响执行效率），一次性读取所有源数据，将其扁平化后合并为单行，再一次性写入目标表格。

优化后代码

// 1. 一次性读取源表格中E12:G15的所有数据（4行3列）
const sourceData = origem.getRange("E12:G15").getValues();

// 2. 将4行3列的二维数组扁平化为1行12列的一维数组
const flattenedData = sourceData.flat();

// 3. 合并前置数据sourceEqpt与扁平化后的数据（假设sourceEqpt为1行3列的二维数组）
const finalRow = [...sourceEqpt[0], ...flattenedData];

// 4. 获取目标表格的下一行行号
const targetRow = sheetBase.getLastRow() + 1;

// 5. 一次性写入整行数据
sheetBase.getRange(targetRow, 1, 1, finalRow.length).setValues([finalRow]);

关键细节说明 #

1. 批量读取：origem.getRange("E12:G15").getValues()直接获取4行3列的二维数组，替代4次单独的getRange+getValues调用。
2. 扁平化处理：flat()方法将二维数组[[E12,F12,G12], [E13,F13,G13], ...]转换为一维数组[E12,F12,G12,E13,F13,G13,...]，完美匹配你需要的单行拼接需求。
3. 单次写入：将合并后的一维数组包裹为[finalRow]（setValues要求传入二维数组），仅需一次写入操作，大幅提升执行效率。

若坚持使用getRangeList的处理方式 #

如果偏好通过getRangeList指定离散范围，需注意其返回的是三维数组（每个范围的二维数组组成的数组），需二次扁平化：

// 定义要读取的离散范围列表
const rangeList = origem.getRangeList(["E12:G12", "E13:G13", "E14:G14", "E15:G15"]);
// 获取所有范围的数据（三维数组）并扁平化两次
const flattenedData = rangeList.getValues().flat(2);

// 后续合并、写入步骤与上述方案一致
const finalRow = [...sourceEqpt[0], ...flattenedData];
const targetRow = sheetBase.getLastRow() + 1;
sheetBase.getRange(targetRow, 1, 1, finalRow.length).setValues([finalRow]);

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