Apps Script调用findEmptyCell函数时Sheet参数异常取值问题

问题根源分析 #

1. 工作表对象获取失败：如果ss.getSheetByName('Итоги')无法匹配到实际工作表（比如名称拼写错误、大小写/空格不一致），sheet3会是undefined，调用sheet.getRange自然会触发“无法读取未定义的getRange属性”错误。
2. Range参数的字符错误：调用时传入的'С4:С34'使用了西里尔字母С，而Google Sheets的列标识是英文C，这会导致transformCords解析出无效范围，进而引发后续getRange调用失败。
3. 函数无返回值的边界情况：如果遍历完指定范围都没找到空单元格，findEmptyCell会返回undefined，此时transformCords(undefined)会生成无效结果，导致后续代码中startPos为undefined，最终在sheet3.getRange调用时出错。

分步解决方案 #

1. 验证工作表对象是否正确获取 #

在工作表定义代码后添加日志，确认sheet3是否有效：

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet1 = ss.getSheetByName('Журнал');  
var sheet2 = ss.getSheetByName('Бар');  
var sheet3 = ss.getSheetByName('Итоги');
// 新增日志验证
Logger.log('sheet3是否存在：' + (sheet3 ? '是' : '否'));

如果日志输出“否”，检查工作表名称是否完全匹配（包括西里尔字母的拼写、大小写、前后空格）。

2. 修正Range参数的字符 #

将调用时的'С4:С34'改为英文C的'C4:C34'：

var emptyCell = findEmptyCell(sheet3, 'C4:C34');

3. 处理函数无返回值的边界情况 #

修改findEmptyCell函数，添加未找到空单元格时的默认返回值，或者在调用前判断结果：

function findEmptyCell(sheet, range) {
  var checkRange = transformCords(range);
  for (var i = checkRange[1][0]; i < checkRange[1][1]; i++) {
    var cell = sheet.getRange(checkRange[0][0] + i);
    if (cell.isBlank()) {
      return cell.getA1Notation();
    }
  }
  // 未找到空单元格时，返回范围最后一行的下一个单元格（可根据需求调整）
  return checkRange[0][0] + checkRange[1][1];
}

调用时增加判断，避免处理undefined：

var emptyCell = findEmptyCell(sheet3, 'C4:C34');
if (!emptyCell) {
  Logger.log('指定范围内未找到空单元格');
  return; // 终止后续代码执行，避免报错
}
var startPos = transformCords(emptyCell);

4. 优化函数性能（可选） #

当前循环中多次调用getRange会增加API调用次数，可优化为一次性获取整个范围的值，提升效率：

function findEmptyCell(sheet, range) {
  var targetRange = sheet.getRange(range);
  var cellValues = targetRange.getValues();
  var startRow = targetRange.getRow();
  // 提取列字母（比如从C4:C34中获取C）
  var colLetter = range.match(/^[A-Z]+/)[0];

  for (var rowIndex = 0; rowIndex < cellValues.length; rowIndex++) {
    if (!cellValues[rowIndex][0]) {
      return colLetter + (startRow + rowIndex);
    }
  }
  // 未找到则返回范围末尾的下一个单元格
  return colLetter + (startRow + cellValues.length);
}

内容的提问来源于stack exchange，提问作者Иван Борисов