Google Sheets脚本中对应Excel VBA的UsedRange的等效功能是什么？

Google Sheets 没有直接对应 Excel VBA 里 UsedRange 的原生属性，但可以通过以下几种方式实现类似的“仅遍历有效区域”的需求：

1. 使用 getDataRange() #

这是最接近 UsedRange 的方法，它会返回工作表中包含当前有数据、公式或格式的最小矩形区域。不过注意：它不会包含“曾经有内容但现已清空”的单元格（这类单元格在Excel的UsedRange中会被纳入）。

示例代码：

function traverseDataRange() {
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const dataRange = activeSheet.getDataRange();
  const cellValues = dataRange.getValues();
  
  // 遍历区域内的所有单元格
  for (let rowIndex = 0; rowIndex < cellValues.length; rowIndex++) {
    for (let colIndex = 0; colIndex < cellValues[rowIndex].length; colIndex++) {
      // 处理单元格内容，比如打印到日志
      console.log(`行${rowIndex+1}列${colIndex+1}：${cellValues[rowIndex][colIndex]}`);
    }
  }
}

2. 用 getLastRow() + getLastColumn() 自定义范围 #

如果需要更灵活地控制范围，可以分别获取工作表的最后一行、最后一列索引，再手动构建目标区域：

示例代码：

function customUsedRange() {
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const lastRow = activeSheet.getLastRow();
  const lastCol = activeSheet.getLastColumn();
  
  // 避免无数据时出错
  if (lastRow === 0 || lastCol === 0) {
    console.log("工作表无有效数据");
    return;
  }
  
  const targetRange = activeSheet.getRange(1, 1, lastRow, lastCol);
  // 后续对区域的操作
}

注意事项 #

和Excel的UsedRange不同，Google Sheets的原生方法不会追踪“曾编辑过但已清空”的单元格。如果你的场景必须包含这类单元格，只能通过检查单元格格式（比如是否设置了自定义格式、边框等）来手动扩展范围，没有原生属性直接支持这一点。

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