如何在Google Sheets中通过GAS正确合并批量单元格区域？

核心问题分析 #

你遇到的合并不完整问题，大概率是合并范围的处理顺序错误或Google Apps Script的操作未及时刷新导致的：

• 如果先处理小范围合并，后续大范围的目标区域可能已经被拆分，导致.merge()无法生效
• 批量操作时，Google Sheets可能会延迟处理，未及时同步合并状态

修复方案：调整处理顺序+强制刷新 #

步骤1：按范围大小降序排序 #

先处理大的合并区域，避免小范围合并干扰后续操作。

步骤2：添加刷新与重复检查 #

每次合并后强制刷新，同时跳过已合并的区域，避免无效操作。

修改后的代码示例：

function copyMergedRangesFixed() {
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("源表");
  const targetSheet = SpreadsheetApp.openById("目标表ID").getSheetByName("目标表");
  let mergedRanges = sourceSheet.getMergedRanges();

  // 按合并范围面积从大到小排序，优先处理大范围
  mergedRanges.sort((a, b) => {
    const areaA = a.getNumRows() * a.getNumColumns();
    const areaB = b.getNumRows() * b.getNumColumns();
    return areaB - areaA;
  });

  mergedRanges.forEach(range => {
    const targetRange = targetSheet.getRange(
      range.getRow(), 
      range.getColumn(), 
      range.getNumRows(), 
      range.getNumColumns()
    );
    
    // 跳过已合并的区域，避免重复操作
    if (!targetRange.isPartOfMerge()) {
      targetRange.merge();
      // 强制刷新，确保操作即时生效
      SpreadsheetApp.flush();
    }
  });
}

替代方案：直接复制格式（更高效） #

如果你的需求是同步数据+格式（包括合并），不需要手动遍历合并范围，直接使用copyTo()的格式复制功能，更可靠且代码更简洁：

function copyDataAndFormatWithMerge() {
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("源表");
  const targetSheet = SpreadsheetApp.openById("目标表ID").getSheetByName("目标表");
  const sourceRange = sourceSheet.getDataRange();
  
  // 先复制格式（含合并单元格）
  sourceRange.copyTo(
    targetSheet.getRange(sourceRange.getRow(), sourceRange.getColumn()),
    SpreadsheetApp.CopyPasteType.PASTE_FORMAT,
    false
  );
  // 再复制值
  sourceRange.copyTo(
    targetSheet.getRange(sourceRange.getRow(), sourceRange.getColumn()),
    SpreadsheetApp.CopyPasteType.PASTE_VALUES,
    false
  );
}

额外排查点 #

1. 目标表权限：确认脚本对目标表有编辑权限
2. 执行时间限制：如果合并范围过多，可拆分批次处理（比如每20个范围执行一次flush，或用时间触发器分阶段运行）
3. 重复范围：检查getMergedRanges()返回的数组是否有重复的范围（可通过记录行/列信息去重）

内容的提问来源于stack exchange，提问作者Andres Martínez Vértiz