Office Scripts行复制粘贴异常问题排查与修复诉求

先给出优化后的完整代码：

function main(workbook: ExcelScript.Workbook) {
    // 获取源表格和目标表格
    const sourceTable = workbook.getTable("PO");
    const targetSheet = workbook.getWorksheet("PO Archive");
    const targetTable = targetSheet.getTable("PO ARCHIVE"); // 假设目标是结构化表格，非表格场景可调整

    if (!sourceTable || !targetTable) {
        console.error("源表格或目标表格不存在");
        return;
    }

    // 获取源表格所有数据行的值
    const sourceValues = sourceTable.getRangeBetweenHeaderAndTotal().getValues();
    // 筛选符合状态条件的行
    const filteredRows = sourceValues.filter(row => {
        const status = row[0]?.toString().trim();
        return status === "Cancelled" || status === "Ordered" || status === "Voided";
    });

    if (filteredRows.length === 0) {
        console.log("没有符合条件的行");
        return;
    }

    // 批量将筛选行添加到目标表格末尾
    targetTable.addRows(-1, filteredRows);

    // （可选）删除源表格中符合条件的行，从后往前删避免索引偏移
    const rowsToDelete: number[] = [];
    sourceTable.getRows().forEach((row, index) => {
        const status = row.getRange().getValues()[0][0]?.toString().trim();
        if (status === "Cancelled" || status === "Ordered" || status === "Voided") {
            rowsToDelete.push(index);
        }
    });

    for (let i = rowsToDelete.length - 1; i >= 0; i--) {
        sourceTable.deleteRowsAt(rowsToDelete[i], 1);
    }
}

问题原因与修复说明 #

1. 仅粘贴空白行的问题 #

原代码错误地用i+3计算工作表行号，完全脱离了表格的实际行位置——表格数据区域的索引和工作表行号没有固定的+3对应关系。改用表格API直接提取行值并批量添加，彻底避免行号计算错误。

2. 整行填充A列值的问题 #

原代码中setValue接收的是单个单元格值，会自动将该值填充到整个目标范围。优化后通过筛选保留整行的二维数组，用addRows()方法批量写入，完整保留每行的多列数据。

3. 循环效率低下的问题 #

原代码循环逻辑混乱（从i=3到vals.length+3的无意义偏移），且逐行操作单元格效率极低。优化后改为：

• 一次性提取所有源数据并筛选，减少重复读取
• 批量写入目标表格，大幅降低Excel交互次数
• 删除行时从后往前遍历，避免删除前序行导致后续索引错位

非表格目标场景适配 #

如果目标不是结构化表格而是普通工作表区域，可将添加行的代码替换为：

// 定位目标工作表的最后数据行
const lastTargetRow = targetSheet.getUsedRange()?.getLastCell().getRowIndex() + 2 || 2; 
// 批量写入筛选后的行
targetSheet.getRange(`A${lastTargetRow}:O${lastTargetRow + filteredRows.length - 1}`).setValues(filteredRows);

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