GSheet AppScript调用getRangeByName报TypeError的解决方法

getRangeByName()是Spreadsheet（工作簿）类的原生方法，仅能在工作簿实例上调用，Sheet（工作表）类没有提供该方法，因此直接在sheet对象上调用会触发"TypeError: sheet.getRangeByName is not a function"报错。

如果需要始终绑定Form Responses工作表的命名范围，将方法调用调整到工作簿实例上即可，额外增加范围归属校验，避免命名范围被误移到其他工作表导致逻辑出错：

const spreadsheet = SpreadsheetApp.getActive();
const TARGET_SHEET = 'Form Responses';
const sheet = spreadsheet.getSheetByName(TARGET_SHEET);

// 从工作簿实例调用命名范围获取方法
const bot_id = spreadsheet.getRangeByName("bot_id");

// 校验范围归属，锁定目标工作表
if (!bot_id || bot_id.getSheet().getSheetName() !== TARGET_SHEET) {
  throw new Error(`命名范围bot_id无效，或不属于${TARGET_SHEET}工作表`);
}

const elements = {
  bot_id: bot_id,
}

const res = elements.bot_id.getValues();

针对需要管理20+个列变量的场景，不需要逐个声明变量赋值，直接维护命名范围名称列表批量生成引用对象即可，后续新增列只要在列表中追加对应命名范围名称，无需修改其他业务逻辑：

function getSheetNamedRanges() {
  const spreadsheet = SpreadsheetApp.getActive();
  const TARGET_SHEET = 'Form Responses';
  const targetSheet = spreadsheet.getSheetByName(TARGET_SHEET);
  // 所有需要引用的命名范围统一在这里维护
  const REQUIRED_RANGES = ["bot_id", "user_id", "submit_time", "response_content", "contact_info"];
  const elements = {};

  REQUIRED_RANGES.forEach(rangeName => {
    // 如果是工作表级命名范围，直接带表名前缀调用，无需额外校验归属
    // const range = spreadsheet.getRangeByName(`${TARGET_SHEET}!${rangeName}`);
    const range = spreadsheet.getRangeByName(rangeName);
    if (!range || range.getSheet().getSheetName() !== TARGET_SHEET) {
      throw new Error(`命名范围${rangeName}配置异常，请检查是否归属${TARGET_SHEET}工作表`);
    }
    elements[rangeName] = range;
  });

  // 业务逻辑调用示例：获取bot_id列所有值
  const botIdValues = elements.bot_id.getValues();
  return elements;
}

优化提示 #

• 建议将固定引用的命名范围设置为工作表级命名范围（创建命名范围时选择范围生效范围为对应工作表，而非整个工作簿），这类范围的完整标识为工作表名!范围名，调用时直接传入完整标识即可天然锁定对应工作表，不会和其他工作表的同名范围冲突。
• 变量声明优先使用const/let替代var，避免变量提升带来的隐性逻辑错误。
• 只要命名范围的指向正确，后续在工作表中新增、删除列都不会影响代码引用，完全满足灵活适配表结构调整的需求。

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