Google Sheets脚本For循环仅执行一次、搜索匹配异常问题求助

• For循环仅执行一次的核心原因：你把return语句放在了for循环的内部，第一次循环跑完不管有没有匹配到，都会直接执行return退出整个函数，所以循环永远只能跑第一轮。
• 关于SEARCH_COL_IDX的取值：Google Sheets的getValues()返回的二维数组是从0开始索引的，A列对应索引0，B列对应索引1，你要搜索B列的话，SEARCH_COL_IDX = 1配置正确，这里没有问题。
• 你之前把判断条件改成if(row[SEARCH_COL_IDX] = str)出现乱匹配的问题：这里是把==（相等判断）写成了=（赋值操作），相当于每次循环都强制把当前行的对应列值改成你要搜索的str，然后这个表达式的返回值永远为真，所以每次都会进入if分支，自然就会出现跨行列的错误匹配结果。

var SPREADSHEET_NAME = "Database";
var SEARCH_COL_IDX = 1; // 对应B列，配置正确
var RETURN_COL_IDX= 1;

function searchStr(){
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var formSS = ss.getSheetByName("Userform");

  var str = formSS.getRange("d17").getValue().trim(); // 加trim去除首尾空格，避免隐性匹配失败
  Logger.log("搜索关键词：" + str);

  var values = ss.getSheetByName("Database").getDataRange().getValues();
  var isFound = false; // 新增匹配标记
  var returnVal = null;

  for (var i = 0; i < values.length; i++) {
    Logger.log("检查第" + (i+1) + "行");
    var row = values[i];
    // 两边都加trim，避免数据表内值带空格导致匹配失败
    if(row[SEARCH_COL_IDX] && row[SEARCH_COL_IDX].toString().trim() == str) {
      formSS.getRange("d3").setValue(row[0]);
      Logger.log(row[0]);
      formSS.getRange("d5").setValue(row[1]);
      Logger.log(row[1]);
      formSS.getRange("d7").setValue(row[2]);
      Logger.log(row[2]);
      formSS.getRange("d9").setValue(row[3]);
      Logger.log(row[3]);
      formSS.getRange("d11").setValue(row[4]);
      Logger.log(row[4]);
      formSS.getRange("d13").setValue(row[5]);
      Logger.log(row[5]);

      isFound = true;
      returnVal = row[RETURN_COL_IDX];
      break; // 如果只需要匹配第一个结果，匹配到就跳出循环；如果需要匹配所有结果，删除这行即可
    }
  }

  if(!isFound) {
    Logger.log("nothing found");
    // 可选：未匹配到时清空表单原有值
    // formSS.getRangeList(["d3","d5","d7","d9","d11","d13"]).clearContent();
  }
  return returnVal;
}

• 给搜索关键词和数据表的匹配值都加了trim()去除首尾空格，绝大多数无报错的匹配失败都是肉眼看不到的前后空格导致的
• 新增匹配标记，只有整个循环跑完都没匹配到才输出未找到日志
• 如果需要匹配所有符合条件的结果，删除break语句，同时调整表单赋值逻辑（比如追加写入而不是覆盖同一个单元格）

内容的提问来源于stack exchange，提问作者Osman P.