Google Sheets Apps Script：能否一次调用批量获取多个命名范围？

太懂这种被服务器I/O拖慢脚本的痛苦了——getRangeByName每次调用都要和Google Sheets服务器做交互，属于典型的性能瓶颈操作，多次叠加后延迟直接拉满，2秒甚至45秒的耗时完全是服务器往返请求堆出来的。

结合你需要完整Range对象、命名范围地址会动态变化的需求，最直接有效的优化思路是把多次服务器调用合并成一次，剩下的操作在本地完成，具体方案如下：

核心优化方案：一次性获取所有命名范围并构建本地映射 #

原来你可能是这样多次调用getRangeByName：

const ss = SpreadsheetApp.getActiveSpreadsheet();
const userRange = ss.getRangeByName("UserList");
const salesRange = ss.getRangeByName("SalesData");
const reportRange = ss.getRangeByName("MonthlyReport");
// ... 更多重复调用

改成一次性拉取所有命名范围，再用本地Map做快速查找：

const ss = SpreadsheetApp.getActiveSpreadsheet();
// 仅1次服务器调用，获取当前表格所有命名范围
const allNamedRanges = ss.getNamedRanges();

// 构建名称到Range对象的映射，后续直接本地取值
const rangeMap = new Map();
allNamedRanges.forEach(namedRange => {
  rangeMap.set(namedRange.getName(), namedRange.getRange());
});

// 本地获取Range，无额外服务器延迟
const userRange = rangeMap.get("UserList");
const salesRange = rangeMap.get("SalesData");
const reportRange = rangeMap.get("MonthlyReport");

为什么这个方案适配你的需求？ #

• 保留完整Range功能：你需要的格式设置、getA1Notation()、offset()等操作都能正常使用，和直接调用getRangeByName得到的Range完全一致。
• 支持动态地址变化：每次执行这段代码时，都会从服务器拉取最新的命名范围数据，哪怕其他函数修改了命名范围的地址，你拿到的都是最新的Range对象。
• 性能大幅提升：原来多次服务器请求的延迟会压缩成仅一次请求的耗时，后续本地查找几乎瞬间完成。

额外小建议 #

如果你的脚本是通过触发器频繁执行的，可以结合CacheService缓存这个映射，但要注意设置较短的过期时间（比如5-10分钟），避免缓存了过时的Range地址。如果脚本每次都是单次运行，一次性获取的方案已经足够高效了。

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