使用Google Apps Script合并Google Docs表格单元格时遇报错

问题现象 #

使用Google Apps Script合并Google Docs表格首行单元格时，执行官方示例代码后，单元格虽完成合并，但切换回文档会触发报错，必须重新加载文档才能恢复。已在Chrome、Firefox浏览器测试，即使是简单测试表格也出现相同问题。

原测试代码 #

function testMerge(){
  var doc = DocumentApp.getActiveDocument();
  var documentTab = doc.getActiveTab().asDocumentTab();
  var body = documentTab.getBody();

  // Example 2: Merge table cells
  // Create a two-dimensional array containing the table's cell contents.
  var cells = [
      ['Row 1, Cell 1', 'Row 1, Cell 2'],
      ['Row 2, Cell 1', 'Row 2, Cell 2']
  ];
  // Build a table from the array.
  var table = body.appendTable(cells);
  // Get the first row in the table.
  var row = table.getRow(0);
  // Get the two cells in this row.
  var cell1 = row.getCell(0);
  var cell2 = row.getCell(1);
  // Merge the current cell into its preceding sibling element.
  var merged = cell2.merge();
}

解决办法及修改后代码 #

问题根源在于getActiveTab()相关操作与文档界面状态存在同步冲突，同时单个单元格merge的方式易引发数据不同步。以下是优化后的代码：

function testMerge(){
  var doc = DocumentApp.getActiveDocument();
  var body = doc.getBody(); // 直接获取文档Body，避免ActiveTab状态冲突

  var cells = [
      ['Row 1, Cell 1', 'Row 1, Cell 2'],
      ['Row 2, Cell 1', 'Row 2, Cell 2']
  ];
  var table = body.appendTable(cells);
  var row = table.getRow(0);
  
  // 直接合并行内指定范围的单元格，操作更稳定
  row.mergeCells(0, 1);
  
  // 强制保存文档，确保修改完全同步到后台
  doc.saveAndClose();
}

优化说明 #

1. 替换ActiveTab获取Body的方式：直接使用doc.getBody()避免了当前标签页实时编辑状态与脚本操作的冲突，减少界面与后台数据不同步的概率。
2. 改用行级合并方法：row.mergeCells(startIndex, endIndex)是更高效的行内单元格合并方式，相比逐个单元格调用merge()，能更稳定地处理单元格合并逻辑。
3. 强制保存文档：doc.saveAndClose()确保脚本执行的所有修改都写入文档，避免因数据未完全同步导致的界面报错。

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