Office Script执行多表格合并示例代码时出现getHeaderRowRange报错

核心问题定位 #

这个报错的本质是脚本尝试访问一个未定义对象的getHeaderRowRange方法，绝大多数情况是目标工作表里不存在规范的Excel结构化表格（List Object）——官方示例代码默认所有要合并的工作表里都有且仅有一个结构化表格，要是某个工作表是空的、只有普通单元格数据没转成表格、或者表格被删除了，就会触发这个错误。

分步修复方案 #

1. 批量检查并标准化所有待合并工作表 #

• 逐个打开待合并的工作表，确认每个工作表里的数据集都已转换为Excel结构化表格：选中数据区域，按Ctrl+T，勾选「我的表格有标题」，点击确定。
• 确保每个工作表里只有一个结构化表格，多余的表格或普通数据区域要清理掉，避免脚本遍历出错。

2. 修改官方脚本增加容错处理 #

官方示例脚本没有异常判断，直接假设所有工作表都有表格，给脚本加个判断逻辑，跳过没有表格的工作表：

function main(workbook: ExcelScript.Workbook) {
  // 创建合并后的目标工作表
  const newSheet = workbook.addWorksheet("合并结果");
  let targetTable: ExcelScript.Table | undefined;

  // 遍历所有工作表
  workbook.getWorksheets().forEach((sheet) => {
    // 只处理非目标工作表的其他表
    if (sheet.getName() !== "合并结果") {
      const tables = sheet.getTables();
      // 新增判断：当前工作表有表格才继续
      if (tables.length > 0) {
        const sourceTable = tables[0];
        if (!targetTable) {
          // 第一个表格直接复制到目标表
          sourceTable.copyTo(newSheet.getRange("A1"), ExcelScript.RangeCopyType.valuesAndFormats);
          targetTable = newSheet.getTables()[0];
        } else {
          // 复制数据行（跳过表头）
          const sourceRange = sourceTable.getRangeBetweenHeaderAndTotal();
          sourceRange.copyTo(targetTable.getRangeBelow(), ExcelScript.RangeCopyType.valuesAndFormats);
        }
      }
    }
  });
}

3. 替代方案：处理普通单元格数据（非结构化表格） #

如果你的数据集本来就是普通单元格（不想转成结构化表格），可以修改脚本直接读取单元格区域：

function main(workbook: ExcelScript.Workbook) {
  const newSheet = workbook.addWorksheet("合并结果");
  let currentRow = 1;

  workbook.getWorksheets().forEach((sheet) => {
    if (sheet.getName() !== "合并结果") {
      const usedRange = sheet.getUsedRange();
      if (usedRange) {
        const values = usedRange.getValues();
        // 第一个工作表复制表头+数据，后续只复制数据（从第二行开始）
        const startRow = currentRow === 1 ? 0 : 1;
        for (let i = startRow; i < values.length; i++) {
          newSheet.getRangeByIndexes(currentRow, 0, 1, values[i].length).setValues([values[i]]);
          currentRow++;
        }
      }
    }
  });
}

录制脚本失效的补充说明 #

录制脚本在工作表数量多时失效，是因为录制的脚本会生成硬编码的工作表名称/索引，工作表数量变化后就会找不到对应对象，用上面的遍历逻辑可以避免这个问题，不管多少工作表都能正常遍历处理。

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