为何循环中搜索函数仅能在首个文件匹配邮箱，后续文件无法匹配？

核心问题诊断 #

你的代码存在三个关键问题导致异常表现：

1. 循环变量全局作用域污染：i、j、q三个循环变量未用var/let声明，属于全局变量。遍历多个文件时，嵌套循环会意外覆盖变量值，导致后续文件的遍历逻辑混乱——这就是首次运行只能处理第一个文件、第二次能处理第二个的原因，每次运行时全局变量的初始状态不同。
2. 匹配后未终止内层循环：找到匹配邮箱后仍会继续遍历data数组，既浪费资源，也可能导致重复写入。
3. 空值边界未处理：当queryString为空时，调用split('@')会报错，中断后续逻辑。

修复后的完整代码 #

function searchQueryForFile() {
  const spreadSheet = SpreadsheetApp.getActive();
  const sheet = spreadSheet.getSheets()[0];
  const participantsArray = sheet.getDataRange().getValues();
  const querySheet = spreadSheet.getSheetByName('Query');
  const data = querySheet.getDataRange().getValues();

  // 替换为实际的列索引（Google Sheets列从0开始计数）
  const participantsDoneId = 0;
  const registrationSheetId = 1;

  for (let i = 1; i < participantsArray.length; i++) {
    const participantsDone = participantsArray[i][participantsDoneId];
    const registrationSheet = participantsArray[i][registrationSheetId];

    if (participantsDone === 'Yes') {
      const file = SpreadsheetApp.openById(registrationSheet);
      console.log(`${i}/${participantsArray.length - 1}-----${file.getName()}`);
      const fileSheet = file.getActiveSheet();
      const fileLastRow = fileSheet.getLastRow();
      const fileLastColumn = fileSheet.getLastColumn();
      const fileSheetUpdateHeaderRange = fileSheet.getRange(1, 10, 1, 28);
      const headerRowUpdate = [['Identified', 'ID', 'Acct Name', 'First Name', 'Last', 'Active in Term', 'Academic Career', 'MastersDoctoral', 'Acad Prog', 'Program Description', 'Acad Plan 1', 'Plan  Description', 'Subplan', 'Subplan Description', 'School/College', 'Department', 'Age', 'Sex', 'Citizenship', 'Ethnicity', 'Best Use Email', 'UWW vs StateSupported', 'Program StartTerm', 'Prg Begin Date', 'Exp Grad Term', 'Exp Grad Date', 'Current Program Status', 'Degree Checkout Status']];
      fileSheetUpdateHeaderRange.setValues(headerRowUpdate);

      if (fileLastRow === 1) {
        continue;
      } else {
        const fileContents = fileSheet.getRange(2, 1, fileLastRow - 1, fileLastColumn).getValues();
        for (let j = 0; j < fileContents.length; j++) {
          const identifiedYesOrNo = fileContents[j][9];

          if (identifiedYesOrNo !== 'Yes') {
            console.log(`------------Participant ${fileContents[j][1]} not identified`);
            const emailString = fileContents[j][1];
            let val = '';
            if (emailString) {
              val = emailString.split('@')[0];
            }

            if (!emailString) {
              fileSheet.getRange(j + 2, 10, 1, 28).setValues([Array(28).fill('')]);              
            } else {
              let found = false;
              for (let q = 1; q < data.length; q++) {
                const queryString = data[q][19];
                if (!queryString) continue; // 跳过空邮箱避免报错
                const queryVal = queryString.split('@')[0];
                if (queryVal === val) {
                  const foundData = [data[q].slice()]; // 浅拷贝避免修改原数组
                  foundData[0].unshift('Yes');
                  console.log(`     Found email in query row ${q + 1} = ${foundData}--${foundData[0].length}`);
                  const fileSheetRange = fileSheet.getRange(j + 2, 10, 1, 28);
                  fileSheetRange.setValues(foundData);
                  found = true;
                  break; // 找到匹配后终止内层循环
                }
              }
              // 未找到匹配时清空对应行
              if (!found) {
                fileSheet.getRange(j + 2, 10, 1, 28).setValues([Array(28).fill('')]);
              }
            }
          }
        }
      }
    }
  }
}

关键修复点说明 #

• 块级作用域变量：所有循环变量改用let声明，确保每个循环的变量独立，不会被跨循环覆盖。
• 匹配后终止循环：找到匹配邮箱后用break终止内层循环，减少不必要的遍历，提升效率。
• 空值安全处理：增加对邮箱字符串的空值判断，避免split方法报错；用Array(28).fill('')简化空行生成代码。
• 数组浅拷贝：用data[q].slice()拷贝匹配数据，避免修改原data数组内容。
• 显式变量声明：补充列索引变量声明，需根据实际表格结构替换为对应索引值。

内容的提问来源于stack exchange，提问作者Bryan Monesson-Olson