Excel Office Script无法清除单元格，提示不可达代码(7027)错误

错误原因解析 #

• cannot find name 'Range'：Office Script基于TypeScript开发，不支持VBA的Range直接调用方式，必须使用ExcelScript标准API定位单元格区域。
• unreachable code detected：这段清除代码被放置在永远不会执行的代码块内（比如return语句之后、永远不满足的条件分支里），需要调整代码位置到正常执行流程中。

正确实现代码 #

要清除B4:B120区域内容但保留格式，使用以下代码：

function main(workbook: ExcelScript.Workbook) {
  // 获取目标工作表（如需指定特定表，替换为getWorksheet("工作表名称")）
  const targetSheet = workbook.getActiveWorksheet();
  // 定位要清除内容的区域
  const clearRange = targetSheet.getRange("B4:B120");
  // 仅清除单元格内容，保留格式
  clearRange.clear(ExcelScript.ClearApplyTo.contents);
}

额外检查点 #

• 确认这段清除代码位于函数的可执行路径中，避免放在return之后或无法触发的条件分支内。
• 如果操作的不是当前激活工作表，将getActiveWorksheet()替换为getWorksheet("具体工作表名")来指定目标表。

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