单元格首次输入后锁定脚本报错：TypeError: Cannot read properties of undefined (reading 'range')

算力阿峰

2026-7-3

修复单元格锁定脚本的TypeError问题

错误原因分析

你遇到的TypeError: Cannot read properties of undefined (reading 'range')主要有两个核心问题：

编辑事件对象的range是属性而非方法，代码里错误写成了event.range()，正确写法是event.range
若手动运行函数，此时没有传入event参数，会直接导致event为undefined

另外代码里的stringDate变量未定义，也会引发后续报错。

修复后的完整代码

function protectOnEdit(event) {
  // 检查事件对象是否存在，避免手动运行报错
  if (!event) {
    throw new Error("请通过触发器运行此函数，不要手动执行");
  }

  var range = event.range;
  // 仅在单元格首次输入内容时执行锁定逻辑
  if (range.getValue() === "") return;

  // 定义时间字符串用于保护描述
  var stringDate = new Date().toLocaleString();
  var description = 'Protected on ' + stringDate;
  var protection = range.protect().setDescription(description);

  var me = Session.getEffectiveUser();
  protection.addEditor(me);
  protection.removeEditors(protection.getEditors());
  if (protection.canDomainEdit()) {
    protection.setDomainEdit(false);
  }
}

关键修复点说明

修正range调用：把event.range()改为event.range，Google Apps Script的编辑事件对象中，range是直接访问的属性，不需要加括号调用。
添加event校验：增加if (!event)判断，防止手动运行函数时因无事件参数触发报错。
补全stringDate定义：用new Date().toLocaleString()生成可读的时间字符串，替换未定义的变量。
增加空值判断：只有当单元格有内容时才执行锁定，避免对空单元格重复操作。