Google Apps Script获取多单元格时校验弹窗不触发问题

Range.getValues() 方法无论选中范围多大，返回值始终是二维数组：外层数组元素对应范围里的每一行，内层数组元素对应当前行的每一列单元格值。

• 单单元格范围B2调用getValues()时返回结构为[["B2单元格实际值"]]，JS做相等判断时会自动对数组调用toString()做类型转换，刚好能和字符串"XXXX"匹配，所以第一段代码碰巧可以运行。
• 多单元格范围B2:B10调用getValues()时返回结构为[["B2值"], ["B3值"], ..., ["B10值"]]，数组转字符串后是逗号拼接的长字符串，不可能直接等于"XXXX"，因此判断条件永远不成立，弹窗不会触发。

需要遍历二维数组，逐个校验每个单元格的值，只要存在匹配项就触发弹窗：

function CheckPlanNumber() {
  // 获取目标工作表B2:B10的范围
  var planNumbersRange = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Plan Numbers").getRange("B2:B10");
  var planNumbers = planNumbersRange.getValues();
  var ui = SpreadsheetApp.getUi(); 
  // 逐行遍历范围
  for (var i = 0; i < planNumbers.length; i++) {
    // 范围仅包含B列，取每行第0个元素就是对应B列单元格的值
    if (planNumbers[i][0] === "XXXX") {
      ui.alert('Contact - Plan Number missing!');
      // 找到匹配项后直接终止函数，无需继续校验剩余单元格
      return;
    }
  }
}

• 读取单个单元格值时，推荐使用getValue()方法（方法名不带s），它会直接返回单元格的具体值，不会返回二维数组，避免隐式类型转换导致的意外问题。
• 多单元格范围读取的二维数组索引从0开始计数，比如范围B2:C10中，B2对应planNumbers[0][0]，C2对应planNumbers[0][1]，B3对应planNumbers[1][0]。

内容的提问来源于stack exchange，提问作者Damián Gómez