本文介绍如何使用 Office Script 的 getUsedRange() 和 getLastCell() 方法，精准获取当前工作表中实际使用的最后一行，并据此动态设置 AutoFill 范围，避免填充空白行或范围不足的问题。
本文介绍如何使用 office script 的 `getusedrange()` 和 `getlastcell()` 方法，精准获取当前工作表中实际使用的最后一行，并据此动态设置 autofill 范围，避免填充空白行或范围不足的问题。
在 Office Script 中实现“智能填充”（即仅填充至数据区域末尾）的关键在于准确识别数据的实际边界，而非依赖固定行号或整列引用。原始脚本中硬编码 "B2:B237" 或扩大至 "B2:B2000" 会导致空白行被错误填充；而使用 "B:B" 则因范围过大触发运行时异常（getRange("B:B") 返回整列对象，不适用于 autoFill 的源单元格逻辑）。
正确做法是利用 Worksheet.getUsedRange() 获取工作表中所有非空单元格构成的最小包围矩形区域，再通过 .getLastCell().getRowIndex() 获取该区域内最后一行的基于零的索引值（注意：ExcelScript 行索引从 0 开始）。由于目标填充起始单元格为 B2（即第 2 行），其对应索引为 1，因此需将 getRowIndex() 结果加 1 才能得到正确的 Excel 行号（如 getRowIndex() 返回 9，表示第 10 行是最后一行，对应 Excel 行号为 10，而 B2 是第 2 行 → 填充范围应为 B2:B10）。
以下是优化后的完整脚本：
function main(workbook: ExcelScript.Workbook) {
let selectedSheet = workbook.getActiveWorksheet();
// 获取已使用区域的最后一行（基于0索引）
let usedLastRow = selectedSheet.getUsedRange()?.getLastCell()?.getRowIndex();
// 安全检查：确保工作表中有数据，避免 undefined 导致运行错误
if (usedLastRow === undefined || usedLastRow < 1) {
console.log("警告：未检测到有效数据区域，跳过自动填充。");
return;
}
// 构造动态填充范围：B2 到 B[最后一行行号]
// 注意：getRowIndex() 返回 0-based 索引，Excel 行号为 1-based，故 +1
const fillRange = `B2:B${usedLastRow + 1}`;
selectedSheet.getRange("B2").autoFill(fillRange, ExcelScript.AutoFillType.fillDefault);
}✅ 关键要点说明：
- getUsedRange() 返回的是连续非空区域的外接矩形，对典型表格（如 A1:C100 内有数据，D 列全空）非常可靠；但若末尾存在孤立空行或跨列空白，可能略有过宽——此时可改用列特定逻辑（如 selectedSheet.getRange("A:A").getSpecialCells(ExcelScript.SpecialCellType.lastCell) 配合 .getRow()，但兼容性略低）。
- 始终添加空值校验（如 ?. 链式调用与 undefined 判断），提升脚本鲁棒性。
- autoFill 的第一个参数必须是字符串格式的地址范围（如 "B2:B100"），不可传入 Range 对象或整列引用。
通过此方法，脚本可自适应任意行数的数据表，真正实现“填到最后一行，不多也不少”。
