求Google Sheets脚本：为活跃用户编辑的单元格添加备注

修正后的完整代码 #

// 编辑触发函数
function onEdit(e) {
  // 获取编辑的单元格范围
  const range = e.range;
  const row = range.getRow();
  // 跳过表头行（若表头在第1行，可根据实际调整）
  if (row === 1) return;

  // 获取时区并格式化编辑时间
  const timeZone = Session.getScriptTimeZone();
  const editDate = new Date();
  const formattedDate = Utilities.formatDate(editDate, timeZone, "yyyy-MM-dd");
  const formattedTime = Utilities.formatDate(editDate, timeZone, "HH:mm:ss");

  // 获取当前用户邮箱，处理授权异常
  let userEmail = "未知用户";
  try {
    userEmail = Session.getActiveUser().getEmail();
  } catch (e) {
    userEmail = "无法获取用户邮箱（需授权或使用可安装触发器）";
  }

  // 构建备注内容
  const noteContent = `最后编辑时间：${formattedDate} ${formattedTime}\n编辑用户：${userEmail}`;

  // 定位对应行B列单元格并设置备注
  const sheet = range.getSheet();
  const targetCell = sheet.getRange(`B${row}`);
  targetCell.setNote(noteContent);
}

代码说明 #

• 触发器逻辑：onEdit(e)是Google Sheets内置的简单触发器，用户编辑单元格时自动触发，e事件对象包含编辑操作的核心信息。
• 表头规避：加入if (row === 1) return;避免给表头行添加备注，可根据你的表格结构调整判断条件。
• 时间格式化：采用yyyy-MM-dd和HH:mm:ss格式，符合国内常用的时间展示习惯，可通过修改Utilities.formatDate的格式字符串自定义样式。
• 邮箱异常处理：简单触发器未授权时无法获取用户邮箱，加入try-catch捕获异常并给出提示；若需稳定获取邮箱，建议创建可安装触发器（需手动授权）。
• 精准定位工作表：使用range.getSheet()获取当前编辑的工作表，避免切换工作表时出现错误。

额外优化方案（可选） #

如果需要保留B列单元格原有的备注，可将新内容追加到原有备注后，替换代码中构建备注的部分：

const existingNote = targetCell.getNote() || "";
const noteContent = existingNote 
  ? `${existingNote}\n---\n最后编辑时间：${formattedDate} ${formattedTime}\n编辑用户：${userEmail}` 
  : `最后编辑时间：${formattedDate} ${formattedTime}\n编辑用户：${userEmail}`;

注意事项 #

1. 授权设置：若要稳定获取用户邮箱，需手动创建可安装触发器：
   • 打开脚本编辑器（工具 > 脚本编辑器）
   • 点击「编辑 > 当前项目的触发器」
   • 添加触发器，选择onEdit函数，事件类型选「从电子表格 > 编辑」
   • 按提示完成授权流程
2. 时区调整：脚本使用项目默认时区，可在脚本编辑器「文件 > 项目属性」中修改。

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