Office Script按列名删列、计算可见单元格列小计及报错解决

• 表对象获取失败：你使用workbook.getTables()[0]会读取整个工作簿中第一个创建的表，和你当前激活的工作表不一定对应，当工作簿内无表或者第一个表不在当前工作表时，table变量会返回undefined，调用它的方法就会触发你看到的报错
• 列名不匹配：你代码中写的待删除列名是Object_Type（带下划线），但实际表头名称是Object Type（带空格），就算表对象获取成功也会找不到对应列

function main(workbook: ExcelScript.Workbook) {
  const selectedSheet = workbook.getActiveWorksheet();
  // 从当前活动工作表获取第一个表，避免跨工作表取错对象
  const table = selectedSheet.getTables()[0];
  if (!table) {
    throw new Error("当前工作表不存在Excel表对象，请先将操作区域转换为「表」结构");
  }

  // 操作1：删除表头为"Object Type"的列
  const delCol = table.getColumnByName("Object Type");
  if (delCol) {
    // 直接调用表对象的删列方法，比操作Range删除更稳定，不会破坏表结构
    table.deleteColumn(delCol.getIndex());
  }

  // 操作2：对"Hits"列筛选后的可见单元格求和
  const hitsCol = table.getColumnByName("Hits");
  if (hitsCol) {
    // 获取Hits列表头以下、汇总行以上的纯数据区域
    const hitsDataRange = hitsCol.getRangeBetweenHeaderAndTotal();
    // SUBTOTAL参数109代表：执行求和计算，自动忽略筛选/手动隐藏的行
    const sumResult = selectedSheet.functions.subtotal(109, hitsDataRange).getValue();
    
    // 示例：将求和结果写在Hits列数据末尾下方2行的位置，可自行修改输出位置
    hitsDataRange.getLastCell()
      .getOffsetRange(2, 0)
      .setValue(`Hits列可见单元格求和结果：${sumResult}`);
  }
}

• 所有表相关操作优先从当前工作表下获取表对象，不要直接从工作簿根路径取索引为0的表，兼容性极差
• getColumnByName方法对列名的匹配是完全精确匹配，必须和表头的空格、大小写、特殊符号完全一致
• 对筛选后可见单元格求和必须用SUBTOTAL函数，不要用普通SUM：参数填109会同时忽略筛选隐藏行、手动隐藏行；如果需要统计手动隐藏的行、仅忽略筛选隐藏行，把参数改成9即可
• 表对象自带的列操作方法（如deleteColumn）会自动维护表结构，比手动选中Range删除更不容易出现格式、引用错误

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