Google AppScript检查单元格值删除列运行报错排查

开发Google Sheets脚本时需要循环检查AF2、AG2、AH2三个单元格的值，若单元格值为#VALUE!则删除对应列。编写的脚本持续运行报错，目标列无法删除，同时存在未定位的循环逻辑错误。

原实现代码 #

function scoreToGrade() {
  var cellsChecked = ['AF2', 'AG2', 'AH2'];
  var sheet = SpreadsheetApp.getActiveSheet();
  for (var i = 0; i < cellsChecked.length; i++) {
    var value = SpreadsheetApp.getActiveSheet()
      .getRange(cellsChecked[i])
      .getDisplayValues();
    console.log(value);
    if (value == '#VALUE!') {
      // do something
      console.log('Not blank ' + value);
      sheet.deleteColumn(cellsChecked + 1);
    } else {
      // do something else
      console.log('is another value ' + value);
    }
  }
}

运行日志 #

3:41:23 PM  Notice  Execution started
3:41:23 PM  Info    [ [ 'TR' ] ]
3:41:23 PM  Info    is BlankTR
3:41:23 PM  Info    [ [ 'F' ] ]
3:41:23 PM  Info    is BlankF
3:41:23 PM  Info    [ [ '#VALUE!' ] ]
3:41:23 PM  Info    Not blank #VALUE!
3:41:23 PM  Error   
Exception: Cannot convert 'AF2,AG2,AH21' to int.
scoreToGrade    @ Code.gs:115

核心报错 #

Exception: Cannot convert 'AF2,AG2,AH21' to int.

• 传参错误直接触发异常：sheet.deleteColumn()方法要求传入整数类型的列序号，原代码传入的是整个数组cellsChecked与数字1拼接的结果。数组隐式转换为字符串时值为AF2,AG2,AH2，拼接1后就得到报错信息里的AF2,AG2,AH21，无法转换为整数，直接抛出类型转换异常。
• 取值逻辑不规范：getDisplayValues()（复数形式）返回的是二维数组结构，即使日志打印看起来匹配到了目标值，直接用二维数组和字符串做相等判断并不可靠，单个单元格取值应使用getDisplayValue()（单数形式）直接获取字符串内容。
• 循环遍历顺序存在隐藏bug：原代码从左往右遍历列，删除左侧列后，右侧所有列会整体左移一位，后续遍历使用的固定A1标记对应的实际单元格会发生偏移，导致漏判、误删问题。

function scoreToGrade() {
  // 调整遍历顺序为从最右侧列到最左侧列，避免删除列导致的位置偏移
  var cellsChecked = ['AH2', 'AG2', 'AF2'];
  var sheet = SpreadsheetApp.getActiveSheet();
  for (var i = 0; i < cellsChecked.length; i++) {
    var targetRange = sheet.getRange(cellsChecked[i]);
    // 单个单元格直接获取字符串值，无需处理二维数组
    var cellValue = targetRange.getDisplayValue();
    console.log(`检查单元格${cellsChecked[i]}，当前值：${cellValue}`);
    if (cellValue === '#VALUE!') {
      var targetCol = targetRange.getColumn();
      console.log(`检测到错误值，删除第${targetCol}列`);
      // 传入整数类型的列序号执行删除
      sheet.deleteColumn(targetCol);
    } else {
      console.log('单元格值正常，跳过');
    }
  }
}

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