如何用Office Script获取非空行数并动态处理首列所有非空行？

问题背景 #

现有脚本仅处理A列前3行数据，需要修改为动态适配A列所有非空行——每次运行时工作簿行数可变，数据间无空行，首个空行即为数据结束，且仅首列有初始数据。每行格式为columnA,columnB,columnC，需按逗号拆分到对应列。

优化后的脚本（逐行处理版） #

function main(workbook: ExcelScript.Workbook) {
    let selectedSheet = workbook.getActiveWorksheet();
    // 动态获取A列所有非空行：从A1向下扩展至最后一个非空单元格
    let sourceRange = selectedSheet.getRange("A1").getExtendedRange(ExcelScript.KeyboardDirection.down);
    let rowCount = sourceRange.getRowCount();

    for (let row = 0; row < rowCount; row++) {
        // 获取当前行值并按逗号拆分
        let cellValue = sourceRange.getRow(row).getValues()[0][0].toString();
        let splitValues = cellValue.split(/[,]/);
        // 将拆分结果写入对应行的多列
        let destinationRange = selectedSheet.getRange("A1").getOffsetRange(row, 0).getResizedRange(0, splitValues.length - 1);
        destinationRange.setValues([splitValues]);
    }
}

更高效的批量处理版（适合大数据量） #

如果数据行数较多，推荐用批量读写的方式减少与Excel的交互次数，提升运行速度：

function main(workbook: ExcelScript.Workbook) {
    let selectedSheet = workbook.getActiveWorksheet();
    // 动态获取A列非空数据范围
    let sourceRange = selectedSheet.getRange("A1").getExtendedRange(ExcelScript.KeyboardDirection.down);
    let allValues = sourceRange.getValues() as string[][];
    
    // 批量拆分所有行数据
    let processedData = allValues.map(row => row[0].toString().split(/[,]/));
    
    // 定位目标写入范围并批量写入
    let targetRange = selectedSheet.getRange("A1").getResizedRange(processedData.length - 1, processedData[0].length - 1);
    targetRange.setValues(processedData);
}

关键改动说明 #

1. 动态获取非空范围
   用getExtendedRange(ExcelScript.KeyboardDirection.down)替代固定的A1:A3：从A1单元格开始向下扩展，自动识别到最后一个非空单元格，完美适配行数变化的场景（符合“数据无空行、首个空行即结束”的规则）。

2. 优化逻辑效率

   • 逐行版：提前获取sourceRange和总行数，避免循环内重复调用范围获取方法。
   • 批量版：一次性读取所有A列数据，处理后一次性写入，大幅减少Excel交互次数，速度提升明显。

3. 简化代码可读性
   将拆分逻辑单独拆分，变量命名更直观，便于后续维护。

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