Excel Office Script 循环问题：匹配名称以"XYZ"开头的工作表批量执行代码/格式修改时遇报错

高频报错原因 #

• 遍历工作表集合时未绑定当前遍历对象的引用，操作空值对象触发类型错误
• 表名匹配逻辑使用严格大小写判断，与实际工作表命名规则不匹配导致逻辑失效
• 批量操作默认作用于当前激活工作表，未将操作目标指向匹配到的目标表，引发跨表操作错位
• 循环内直接通过表名索引获取工作表，未做存在性校验时触发目标对象不存在的错误

可直接复用的实现代码 #

function main(workbook: ExcelScript.Workbook) {
  // 获取当前工作簿的全部工作表
  const worksheets = workbook.getWorksheets();
  // 定义需要匹配的目标表名前缀
  const targetPrefix = "XYZ";

  worksheets.forEach((sheet) => {
    // 匹配表名前缀，toUpperCase() 可实现不区分大小写匹配
    if (sheet.getName().toUpperCase().startsWith(targetPrefix.toUpperCase())) {
      // 以下为需要批量执行的格式/业务逻辑，所有操作需绑定当前sheet对象
      // 示例1：调整A列列宽为15
      sheet.getRange("A:A").format.setColumnWidth(15);
      // 示例2：隐藏工作表网格线
      sheet.getPageLayout().setShowGridlines(false);
    }
  });
}

操作注意事项 #

• 循环内不要硬编码工作表获取逻辑，所有格式调整、数据修改操作必须绑定当前遍历到的sheet对象，否则会出现操作错表、引用为空的报错
• 若需要排除隐藏工作表，可在匹配判断中增加sheet.getVisibility() === ExcelScript.SheetVisibility.visible的过滤条件
• 批量操作过程中无需调用sheet.activate()方法切换激活表，这会大幅增加脚本运行耗时
• 若需要调整匹配规则（如按表名后缀匹配、包含特定字符匹配），仅需修改if分支内的字符串判断逻辑即可，不需要调整整体循环结构

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