如何解决Google Apps Script合并单元格时的完整范围选择错误

问题根源 #

1. 初始行索引错误：原代码startRowIndex = 1跳过了第一组数据的起始行，导致首次运行部分行未合并
2. 未处理已合并单元格：重复运行时，现有合并单元格会触发You must select all cells in a merged range...错误，需先解除目标列的所有合并

修正后的代码 #

function mergeCustomerOrderRows() {
  const spreadsheetId = "GOOGLE_SHEET_ID";
  const sheetName = "SHEET_NAME";
  const mergeColumns = [0, 1, 2, 3, 4]; // 不合并Product ID(索引5)

  try {
    const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
    const sheet = spreadsheet.getSheetByName(sheetName);

    if (!sheet) throw new Error(`Sheet "${sheetName}" not found.`);

    // 先解除目标列的所有合并，避免重复运行报错
    mergeColumns.forEach(colIndex => {
      const colRange = sheet.getRange(2, colIndex + 1, sheet.getLastRow() - 1, 1);
      colRange.unmerge();
    });

    const dataRange = sheet.getRange(2, 1, sheet.getLastRow() - 1, sheet.getLastColumn());
    const data = dataRange.getValues();
    
    let startRowIndex = 0; // 修正初始索引为数据数组的起始位置
    for (let i = 1; i < data.length; i++) {
      // 当当前行Customer Name与上一行不同时，处理上一组
      if (data[i][1] !== data[i - 1][1]) {
        if (startRowIndex < i) {
          mergeColumns.forEach(colIndex => {
            // 表格行号 = 数据索引 + 2（因为数据从第2行开始）
            const range = sheet.getRange(startRowIndex + 2, colIndex + 1, i - startRowIndex, 1);
            range.merge();
          });
        }
        startRowIndex = i;
      }
    }

    // 处理最后一组数据
    if (startRowIndex < data.length) {
      mergeColumns.forEach(colIndex => {
        const range = sheet.getRange(startRowIndex + 2, colIndex + 1, data.length - startRowIndex, 1);
        range.merge();
      });
    }

    SpreadsheetApp.flush();
    Logger.log("按第二列匹配完成合并");
    return ContentService.createTextOutput("已根据第二列条件成功合并单元格");
  } catch (error) {
    Logger.log(`错误: ${error.message}`);
    return ContentService.createTextOutput(`错误: ${error.message}`);
  }
}

关键修改点 #

• 解除现有合并：在处理前遍历目标列，解除所有已合并单元格，解决重复运行报错问题
• 修正起始索引：将startRowIndex初始值改为0，确保第一组相同Customer Name的行能被正确识别合并
• 调整行号计算：表格行号 = 数据数组索引 + 2（数据从表格第2行读取），避免行号偏移

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