如何在Google Apps Script中高效合并N个选定列区域的数值？

需求背景 #

已知可通过=concat函数实现列合并，但需在Google表格的Apps Script中做成按钮触发功能，支持处理N个选定列区域。

输入输出示例 #

输入数组（两个区域的嵌套结构） #

[ 
  [ [ 'Joe Smith' ], [ 'Joe Johnson' ], [ '' ], [ 'Joe Jensen' ] ],
  [ [ '(479)123-4567' ], [ '' ], [ '(479) 321-1234' ], [ '479-987-0987' ] ]
]

期望输出数组（合并为单列，值用空格分隔，空值导致的多余空格可后续清理） #

[ 
  [ 'Joe Smith (479)123-4567' ],
  [ 'Joe Johnson ' ],
  [ '(479) 321-1234' ],
  [ 'Joe Jensen 479-987-0987' ],
  [ ' (479)123-4567' ]
]

核心疑问 #

处理N个选定列区域时，Apps Script中最高效的合并方式是什么？若将数万条数据存入中间数组再循环合并，是否会造成内存浪费？有没有更简便的实现方法？

现有前置代码 #

let sel = SpreadsheetApp.getActive().getSelection().getActiveRangeList().getRanges();
let spreadsheet = SpreadsheetApp.getActiveSheet();
// ...
lastCol = null;
firstCol = null;
if (sel.length == 1) {
    lastCol = spreadsheet.getActiveRange().getLastColumn();
    firstCol = (lastCol - spreadsheet.getActiveRange().getNumColumns() + 1);
} else {
    lastCol = spreadsheet.getActiveRange().getLastColumn();
    firstCol = (lastCol - sel.length + 1);
};
let arr = [];
arr.push(firstCol);
arr.push(lastCol);
let colArray = missingNumbers(arr).concat(arr).sort();
console.log(colArray);
let range = spreadsheet.getRange(colArray[0], 1, 1, colArray.length).getDataRegion(SpreadsheetApp.Dimension.ROWS).activate();

注：已获取区域数组或嵌套列表形式的区域值，且确保所选列/行结构对称，分支逻辑用于适配拖拽选多列或Ctrl+点击选多列的场景。

解决方案 #

高效合并思路 #

1. 减少内存冗余：避免创建不必要的中间数组，直接按行维度对多列数据进行合并
2. 批量IO操作：利用getValues()和setValues()批量读写表格数据，这是提升性能的核心——表格IO操作的耗时远高于内存运算

实现代码 #

function mergeSelectedColumns() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const selection = ss.getSelection().getActiveRangeList().getRanges();
  
  // 获取所有选定列的数据，统一补全行数以匹配最长列
  const maxRows = Math.max(...selection.map(range => range.getNumRows()));
  const columnData = selection.map(range => {
    const values = range.getValues().map(row => row[0]); // 转为一维数组
    // 为空行补全空字符串，保证所有列行数一致
    while (values.length < maxRows) values.push('');
    return values;
  });
  
  // 按行合并所有列的对应值
  const mergedResult = columnData[0].map((_, rowIdx) => {
    // 可选：过滤空值减少多余空格，不需要可直接用columnData.map(col => col[rowIdx]).join(' ')
    return [columnData.map(col => col[rowIdx]).filter(val => val !== '').join(' ')];
  });
  
  // 将结果写入表格最后一列右侧（可根据需求调整输出位置）
  const outputCol = sheet.getLastColumn() + 1;
  sheet.getRange(1, outputCol, mergedResult.length, 1).setValues(mergedResult);
}

关键优化点 #

• 按行映射合并：借助数组map方法，以第一列的行索引为基准，直接提取所有列对应行的值进行合并，避免多层嵌套循环
• 批量读写：一次性读取所有选定列的数据，合并完成后一次性写入表格，大幅减少与表格的交互次数
• 可选空值过滤：代码中加入filter(val => val !== '')提前剔除空值，减少多余空格，若需要保留原始空值的空格可直接移除该逻辑

性能说明 #

对于数万条数据的场景，该方案内存占用可控：仅存储原始列的一维数据和最终合并结果，无冗余中间存储。对比逐行循环读写表格的方式，性能提升非常显著。

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