如何在Google Apps Script中动态获取Google Sheet排除表头的表格范围

针对固定范围字符串"B2:G998"在删除行/列后失效的问题，以下脚本可动态生成排除第1行（表头）的表格范围标识（格式如B2:GXX）：

完整脚本 #

function getDynamicTableRange() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  // 获取最后一行/列的内容边界
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();

  // 无数据时返回空字符串
  if (lastRow <= 1) return "";

  // 转换列号为字母
  const startCol = columnToLetter(2); // 起始列固定为B（对应列号2）
  const endCol = columnToLetter(lastCol);

  // 拼接范围字符串
  return `${startCol}2:${endCol}${lastRow}`;
}

// 辅助函数：列号转Excel风格字母
function columnToLetter(column) {
  let letter = "";
  while (column > 0) {
    const remainder = (column - 1) % 26;
    letter = String.fromCharCode(65 + remainder) + letter;
    column = Math.floor((column - 1) / 26);
  }
  return letter;
}

关键说明 #

• getLastRow()/getLastColumn()：自动识别工作表中最后一个有内容的行/列，确保范围始终匹配实际数据边界。
• columnToLetter：将数字列号转换为Excel风格的列字母（如2→B），是拼接范围字符串的必需步骤。
• 起始行固定为2，对应排除第1行表头；若起始列也需要动态调整，可将columnToLetter(2)中的2替换为动态获取的起始列号。

使用示例 #

调用函数获取范围后，可直接用于后续操作：

function testDynamicRange() {
  const rangeStr = getDynamicTableRange();
  console.log("当前动态范围：", rangeStr);
  // 基于范围字符串获取Range对象
  const targetRange = SpreadsheetApp.getActiveSheet().getRange(rangeStr);
}

内容的提问来源于stack exchange，提问作者Excel Ross Omisol