Office Scripts新建表格前删除原有同名表格的实现方法

以下两种实现逻辑均可解决旧表无法覆盖的问题，可根据业务场景选择：

方案1：保留表结构仅清空数据（推荐用于固定结构的录入场景） #

如果后续流程需要反复使用同一张表、表格列结构固定，不需要每次删除重建表格，直接清空旧表的存量数据即可，性能更好，也不会出现Power Automate中表引用失效的问题。
修改后的完整脚本如下：

function main(workbook: ExcelScript.Workbook,
    TableName: string = "Table1",
    SheetName: string = "Sheet1"
) {
    const selectedSheet = workbook.getWorksheet(SheetName);
    // 匹配同名旧表
    const existingTable = selectedSheet.getTables().find(table => table.getName() === TableName);

    if (existingTable) {
        // 仅清空表头以下的所有数据内容，保留表头和表结构
        const dataBodyRange = existingTable.getRangeBetweenHeaderAndTotal();
        dataBodyRange.clear(ExcelScript.ClearApplyTo.contents);
        // 如需同时清除格式、数据验证、条件格式，可将参数替换为 ExcelScript.ClearApplyTo.all
        return existingTable;
    }

    // 无旧表时按原逻辑创建新表
    const newTable = workbook.addTable(selectedSheet.getUsedRange(), true);
    newTable.setName(TableName);
    return newTable;
}

方案2：删除旧表后重建（适配原有脚本逻辑） #

如果每次写入的数据范围、列结构不固定，必须重建表格，只需要在新建逻辑前增加同名旧表的删除步骤即可。注意遍历删除表格时要倒序遍历集合，避免索引偏移导致漏删。
修改后的完整脚本如下：

function main(workbook: ExcelScript.Workbook,
    TableName: string = "Table1",
    SheetName: string = "Sheet1"
) {
    const selectedSheet = workbook.getWorksheet(SheetName);
    // 获取当前工作表下的所有表格，倒序遍历删除同名旧表
    const sheetTables = selectedSheet.getTables();
    for (let i = sheetTables.length - 1; i >= 0; i--) {
        if (sheetTables[i].getName() === TableName) {
            sheetTables[i].delete();
        }
    }

    // 旧表清理完成后创建新表
    const newTable = workbook.addTable(selectedSheet.getUsedRange(), true);
    newTable.setName(TableName);
}

注意事项 #

• 脚本运行前要确保传入的SheetName对应的工作表真实存在，否则会触发空引用报错
• 上述删除逻辑只会匹配和传入参数TableName同名的表格，不会误删工作表内的其他表格
• 方案2执行删除操作时，旧表关联的所有公式引用、Power Automate绑定步骤都会失效，仅适合表结构频繁变动的临时表场景

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