Google表格Apps Script报错：TypeError: 无法读取null的getRange属性

错误原因 #

这个报错的核心是：代码调用getSheetByName()获取工作表时返回了null（找不到指定名称的工作表），后续对这个null对象调用getRange()就会触发该类型错误。你的代码里大概率是ENERO2024或datos其中一个变量为null。

解决方案 #

1. 核对工作表名称 #

确认你的Google表格中确实存在名称为ENERO2024和Datos的工作表，注意：

• 名称大小写完全匹配（比如不能把ENERO2024写成Enero2024）
• 没有多余的空格或特殊字符（比如工作表名称末尾有没有空格）

2. 添加工作表存在性检查 #

在使用工作表对象前先判断是否获取成功，避免报错：

function Guardar(){
  var hojaActiva = SpreadsheetApp.getActiveSpreadsheet();
  var ENERO2024 = hojaActiva.getSheetByName("ENERO2024");
  var datos = hojaActiva.getSheetByName("Datos");

  // 检查工作表是否存在，不存在则弹窗提示并终止执行
  if (!ENERO2024 || !datos) {
    SpreadsheetApp.getUi().alert("找不到指定的工作表，请检查名称是否正确！");
    return;
  }

  // 读取各单元格值
  var fecha = ENERO2024.getRange("B2:E2").getValue();
  var vendedor = ENERO2024.getRange("B3:E3").getValue();
  var hEntrada = ENERO2024.getRange("B4:E4").getValue();
  var hSalida = ENERO2024.getRange("B5:E5").getValue();
  var heladosVendidos = ENERO2024.getRange("D14").getValue();
  var paca = ENERO2024.getRange("B16:B17").getValue();
  var fresa = ENERO2024.getRange("D7").getValue();
  var cajeta = ENERO2024.getRange("D8").getValue();
  var oblea = ENERO2024.getRange("D9").getValue();
  var oreo = ENERO2024.getRange("D10").getValue();
  var galleta = ENERO2024.getRange("D11").getValue();
  var vGrande = ENERO2024.getRange("D12").getValue();
  var vChico = ENERO2024.getRange("D13").getValue();
  var dineroTotal = ENERO2024.getRange("D16:D17").getValue();
  var otroValor = ENERO2024.getRange("E16:E17").getValue();

  // 整理成二维数组（setValues要求传入二维数组）
  var valores = [[fecha, vendedor, hEntrada, hSalida, heladosVendidos, paca, fresa, cajeta, oblea, oreo, galleta, vGrande, vChico, dineroTotal, otroValor]];

  // 修复getRange参数错误：正确格式是getRange(起始行, 起始列, 行数, 列数)
  datos.getRange(datos.getLastRow() + 1, 1, valores.length, valores[0].length).setValues(valores);
}

3. 修复getRange参数错误 #

你原代码中datos.getRange(datos.getLastRow()+1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,15)的参数格式完全错误，getRange的合法参数格式是getRange(row, column, numRows, numColumns)，只需要4个参数，多余的参数会导致异常。上面的修复代码使用了更通用的写法，自动匹配数组的行数和列数，避免手动计算出错。

4. 可选：优化代码效率（进阶） #

多次调用getRange会降低脚本执行速度，新手可以先保证功能正常，之后再尝试批量读取数据：

// 一次性读取所有需要的单元格范围
var allValues = ENERO2024.getRange("B2:E2,B3:E3,B4:E4,B5:E5,D7:D14,B16:B17,D16:D17,E16:E17").getValues();
// 从批量读取的结果中提取对应值
var fecha = allValues[0][0];
var vendedor = allValues[1][0];
// 以此类推提取其他值...

内容的提问来源于stack exchange，提问作者Oscar Partido Ramirez