如何修复TypeError: Cannot read properties of undefined (reading 'getRange')错误

错误原因 #

1. 参数未定义：如果直接运行lockCells函数而未传入参数，spreadsheet参数会是undefined，导致调用getRange时触发TypeError。
2. 代码结构错误：if代码块未正确闭合，且在块内冗余递归调用lockCells，逻辑混乱。
3. 锁定逻辑缺失：setLocked(true)仅在工作表存在保护规则时生效，原代码未创建保护规则，即使参数正确也无法锁定单元格。

修复后的代码 #

function lockCells() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const triggerCell = "B1";
  const targetRange = "A1:A5";

  const triggerValue = sheet.getRange(triggerCell).getValue();
  if (triggerValue !== true) return;

  // 创建或获取工作表保护
  let protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
  if (!protection) {
    protection = sheet.protect().setDescription("Auto-lock range A1:A5");
    // 保留当前用户编辑权限，移除其他编辑者
    const currentUser = Session.getEffectiveUser();
    protection.addEditor(currentUser);
    protection.removeEditors(protection.getEditors());
    protection.setDomainEdit(false);
  }

  // 锁定目标范围
  const range = sheet.getRange(targetRange);
  protection.setRange(range).setLocked(true);
}

核心修复点 #

• 移除冗余递归，直接在函数内获取活动工作表，避免参数传递错误。
• 添加工作表保护逻辑，确保setLocked方法能生效，同时合理设置编辑权限。
• 优化逻辑：若触发单元格值不为true，直接退出函数，减少无效执行。

使用方式 #

直接运行lockCells函数即可；若需要自动触发，可设置onEdit或onChange触发器，实现当B1值变为TRUE时自动锁定范围。

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