如何在Google Sheets中通过迭代Vlookup将内容添加为单元格备注？

首先明确：没有无需脚本的简便方法，因为Google Sheets内置函数无法直接给单元格添加悬浮批注，必须通过Apps Script实现。以下是适配你需求的完整脚本，附带新手友好的分步说明：

完整脚本代码 #

function addProjectDescriptionNotes() {
  // 获取当前打开的表格
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // 获取两个工作表对象
  const descSheet = ss.getSheetByName('PROJECT_DESCRIPTION');
  const displaySheet = ss.getSheetByName('PROJECT_DISPLAY');
  
  // 读取PROJECT_DESCRIPTION的所有数据（第一行是表头）
  const descData = descSheet.getDataRange().getValues();
  
  // 构建项目名到描述的映射表（替代Vlookup，效率更高）
  const projectDescMap = {};
  // 从第二行开始遍历（跳过表头）
  for (let i = 1; i < descData.length; i++) {
    const projectName = descData[i][0]; // 第一列是Project Name
    const projectDesc = descData[i][1]; // 第二列是Project Description
    if (projectName && projectDesc) { // 跳过空行
      projectDescMap[projectName] = projectDesc;
    }
  }
  
  // 读取PROJECT_DISPLAY的项目名列数据（假设第一列是Project Name，第一行是表头）
  const displayNames = displaySheet.getRange(2, 1, displaySheet.getLastRow() - 1, 1).getValues();
  
  // 遍历每个项目名，添加/更新批注
  displayNames.forEach((row, index) => {
    const projectName = row[0];
    const targetCell = displaySheet.getRange(index + 2, 1); // 对应表格中的单元格（从第二行开始）
    
    if (projectName && projectDescMap[projectName]) {
      // 设置批注，若已有批注则覆盖
      targetCell.setNote(projectDescMap[projectName]);
    } else if (projectName) {
      // 没有找到对应描述时，清空原有批注（可选，可删除此行）
      targetCell.clearNote();
    }
  });
  
  // 运行完成提示
  SpreadsheetApp.getUi().alert('项目描述批注已批量更新完成！');
}

新手操作步骤 #

1. 打开你的Google Sheets表格
2. 点击顶部菜单栏的 扩展 > Apps Script，打开脚本编辑器
3. 删除编辑器里的默认代码，粘贴上面的完整脚本
4. 点击编辑器顶部的保存按钮，给脚本起个名字（比如AddProjectNotes）
5. 点击运行按钮，首次运行会要求授权，按照提示完成授权即可

代码逻辑说明 #

• 替代Vlookup的部分：脚本先把PROJECT_DESCRIPTION的所有项目名和描述存入一个对象projectDescMap，这样后续查找描述时直接通过项目名取对应值，比循环调用Vlookup函数效率高得多
• 迭代逻辑：遍历PROJECT_DISPLAY的每一行项目名，逐个匹配映射表中的描述，给对应单元格添加批注
• 容错处理：跳过空行，没有找到描述时可以选择清空原有批注（可根据需求调整）

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