Office Script在XLS文件调用getUsedRange报错，求替代方案

XLS是Excel的旧二进制格式（BIFF8），XLSX则是基于Open XML的新格式。Office Script的API对XLS格式的支持存在局限性，尤其是getUsedRange这类需要解析文件内部已用区域的接口：

• XLS的存储结构与XLSX差异极大，API在解析XLS的已用范围时，可能遇到文件内的隐藏格式残留、无效单元格标记等问题，触发内部错误。
• 你测试的现象完全符合这个逻辑：转存为XLSX后格式适配API，硬编码范围跳过了getUsedRange的解析步骤，因此都能正常运行。

以下几种方法可以绕过getUsedRange，稳定获取工作表的有效数据范围：

方法1：从指定列/行定位最后有数据的单元格 #

通过指定关键列（比如数据起始的A列）或行，从底部往上查找最后一个非空单元格，再组合成完整范围。这种方法在XLS文件中兼容性更好：

function main(workbook: ExcelScript.Workbook) {
  let ws = workbook.getActiveWorksheet();
  
  // 定位A列最后一个有数据的单元格（行索引从0开始，+1转为实际行号）
  let lastRow = ws.getRange("A:A").getLastCell().getRowIndex() + 1;
  // 定位第1行最后一个有数据的单元格（列索引从0开始，+1转为实际列号）
  let lastCol = ws.getRange("1:1").getLastCell().getColumnIndex() + 1;
  
  // 组合成数据范围（起始行1，起始列1，行数lastRow，列数lastCol）
  let dataRange = ws.getRange(1, 1, lastRow, lastCol);
  
  let newTable = ws.addTable(dataRange, true);
  newTable.setName("TableTKO");
}

注意：如果你的数据起始行/列不是第1行/第A列，需要调整对应的范围（比如"B:B"或"2:2"）。

方法2：使用getUsedRangeOrNullObject容错处理 #

这个方法不会直接抛出错误，而是返回null，可以在获取失败时用兜底逻辑：

function main(workbook: ExcelScript.Workbook) {
  let ws = workbook.getActiveWorksheet();
  let range = ws.getUsedRangeOrNullObject();
  
  if (!range) {
    // 兜底逻辑：手动指定范围或用方法1的方式获取
    let lastRow = ws.getRange("A:A").getLastCell().getRowIndex() + 1;
    let lastCol = ws.getRange("1:1").getLastCell().getColumnIndex() + 1;
    range = ws.getRange(1, 1, lastRow, lastCol);
  }
  
  let newTable = ws.addTable(range, true);
  newTable.setName("TableTKO");
}

方法3：逐行检测有效数据（适合小数据集） #

如果数据量不大，可以从工作表底部往上逐行检查是否有数据，直到找到第一个非空行：

function main(workbook: ExcelScript.Workbook) {
  let ws = workbook.getActiveWorksheet();
  let maxRow = ws.getUsedRangeOrNullObject()?.getRowCount() || 1000; // 预设最大检查行数
  
  // 从底部往上找最后一个有数据的行
  let lastRow = 1;
  for (let i = maxRow; i >= 1; i--) {
    let rowRange = ws.getRange(`A${i}:Z${i}`); // 假设数据在A-Z列范围内
    if (rowRange.getValues().flat().some(cell => cell !== "")) {
      lastRow = i;
      break;
    }
  }
  
  // 同理找最后一列
  let lastCol = 1;
  for (let i = 26; i >= 1; i--) { // 检查A-Z列
    let colRange = ws.getRange(`A1:${String.fromCharCode(64+i)}${lastRow}`);
    if (colRange.getValues().flat().some(cell => cell !== "")) {
      lastCol = i;
      break;
    }
  }
  
  let dataRange = ws.getRange(1, 1, lastRow, lastCol);
  let newTable = ws.addTable(dataRange, true);
  newTable.setName("TableTKO");
}

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