如何在Google文档表格中使用For Loop遍历并更新指定行

我经常处理这类跨Google Workspace的自动化任务，下面给你一套完整的实现方案，用Google Apps Script就能轻松完成ID匹配和表格更新：

核心思路 #

1. 读取Google文档中的目标表格
2. 读取Google表格里的数据源（包含要更新的ID和新数据）
3. 遍历文档表格的每一行，严格匹配第一列的ID
4. 匹配成功时，用数据源里的新数据替换该行的对应列内容

完整代码实现 #

function updateDocTableFromSheet() {
  // 替换成你的Google文档ID和表格ID
  const DOC_ID = "你的Google文档ID";
  const SHEET_ID = "你的Google表格ID";
  
  // 获取Google文档中的表格（假设文档里只有一个表格，若多个可调整索引）
  const doc = DocumentApp.openById(DOC_ID);
  const tables = doc.getTables();
  if (tables.length === 0) {
    console.log("文档中未找到表格");
    return;
  }
  const targetTable = tables[0];
  
  // 获取Google表格的数据源（假设数据从A1开始，第一行是表头）
  const sheet = SpreadsheetApp.openById(SHEET_ID).getActiveSheet();
  const sourceData = sheet.getDataRange().getValues();
  // 把数据源转成ID为键的对象，方便快速查找
  const dataMap = {};
  for (let i = 1; i < sourceData.length; i++) { // 跳过表头
    const row = sourceData[i];
    const id = row[0].toString(); // 统一转成字符串避免类型匹配问题
    dataMap[id] = {
      name: row[1],
      favouriteCheese: row[2]
    };
  }
  
  // 遍历文档表格的每一行（跳过表头，从第二行开始）
  const rows = targetTable.getRows();
  for (let i = 1; i < rows.length; i++) {
    const row = rows[i];
    const cells = row.getCells();
    if (cells.length === 0) continue;
    
    // 获取当前行的ID，统一转成字符串并去除空格
    const currentId = cells[0].getText().trim().toString();
    
    // 检查是否在数据源中存在匹配的ID
    if (dataMap[currentId]) {
      // 更新name列（第二列）
      cells[1].setText(dataMap[currentId].name);
      // 更新favourite cheese列（第三列）
      cells[2].setText(dataMap[currentId].favouriteCheese);
      console.log(`已更新ID为${currentId}的行`);
    }
  }
  
  // 保存文档更改
  doc.saveAndClose();
  console.log("表格更新完成！");
}

关键细节说明 #

• ID匹配处理：我把ID统一转成字符串并去除首尾空格，避免因为数字/字符串类型不一致、单元格有多余空格导致匹配失败的问题
• 数据源映射：把Google表格的数据转成以ID为键的对象，这样每次查找的效率是O(1)，比每次遍历数据源要高效很多
• 表格索引：如果你的Google文档里有多个表格，需要调整tables[0]的索引；如果数据源的表头结构不同，要对应修改row[1]、row[2]的列索引
• 权限问题：第一次运行脚本时，需要授权Google Apps Script访问你的文档和表格，按照提示完成授权即可

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