本文介绍如何使用 Office Script 的 getUsedRange() 和 getLastCell() 方法，精准获取当前工作表中实际使用的最后一行，并据此动态设置 autoFill 范围，避免填充空白行或范围越界。
本文介绍如何使用 office script 的 `getusedrange()` 和 `getlastcell()` 方法，精准获取当前工作表中实际使用的最后一行，并据此动态设置 `autofill` 范围，避免填充空白行或范围越界。
在 Office Script 中实现“智能自动填充”，关键在于准确识别数据区域的边界，而非依赖固定行号。原始脚本中硬编码 "B2:B237" 或扩大至 "B2:B2000" 会导致空白行被错误填充，而 "B:B" 则因范围过大触发 API 限制或逻辑异常。
正确做法是利用 ExcelScript 提供的 getUsedRange() 方法——它返回工作表中所有非空单元格构成的最小矩形区域（即“已使用范围”），再通过 .getLastCell() 获取该区域内右下角的单元格，最后调用 .getRowIndex()（注意：索引从 0 开始）获得最后一行的0 基索引值。由于目标填充起始于 B2（即第 2 行，1 基索引），而 getRowIndex() 返回的是 0 基索引，因此需加 1 才能得到正确的 1 基行号。
以下是优化后的完整脚本：
function main(workbook: ExcelScript.Workbook) {
let selectedSheet = workbook.getActiveWorksheet();
// 获取已使用范围的最后一个单元格（右下角）
let lastCell = selectedSheet.getUsedRange()?.getLastCell();
// 安全检查：确保工作表中存在已使用范围（避免空表报错）
if (!lastCell) {
console.log("警告：当前工作表为空，未执行自动填充。");
return;
}
let usedLastRow = lastCell.getRowIndex(); // 0 基索引
let fillEndRow = usedLastRow + 1; // 转换为 1 基索引行号
// 确保起始行 B2 不超过数据区域（例如空表或仅首行有数据时）
if (fillEndRow < 2) {
fillEndRow = 2;
}
let fillRange = `B2:B${fillEndRow}`;
selectedSheet.getRange("B2").autoFill(fillRange, ExcelScript.AutoFillType.fillDefault);
}✅ 关键要点说明：
- getUsedRange() 会忽略完全空白的行列，但会包含格式化（如边框、背景色）或公式结果为空的单元格——若业务场景要求严格按有值数据判断，建议改用列遍历法（如 getColumn(1).getSpecialCells(ExcelScript.SpecialCellType.constants)），但性能较低；
- 示例中增加了空表防护和边界校验，提升脚本鲁棒性；
- autoFill 的源单元格（"B2"）必须包含有效内容或公式，否则填充可能无效果；
- 若目标列（B 列）本身数据不连续（如中间有空行），getUsedRange() 仍以整个数据块的最大外接矩形为准，此时需结合具体业务逻辑另行处理。
掌握此模式后，可轻松扩展至多列填充、跨表动态范围等场景，真正实现“一次编写、多表适用”的自动化流程。
