Google App Script(Workspace插件)获取电子表格全工作表选中范围

• sheet.getActiveRangeList() 接口仅对当前处于激活状态的工作表生效，所有非激活工作表调用该接口时，不会返回自身的历史选中范围，会默认返回当前活动表的选中内容，这是你所有工作表都拿到A表选区的核心原因。
• 原代码遍历rangeList时错误使用for...in语法，该语法遍历数组时拿到的是数组索引值，不是Range对象本身，即使选区获取正确，这行代码也会抛出类型错误。

Google Apps Script 原生Spreadsheet服务没有提供直接读取非活动工作表选中范围的接口，需要通过选区变更触发器+文档属性缓存的方式持久化各工作表的最后选中状态，适配Workspace非绑定插件场景：

1. 注册Selection change触发器，每次用户修改选中区域时，自动将当前工作表的选中范围存入文档属性缓存
2. 需要拉取全量选中范围时，直接从缓存读取所有工作表的选区记录，过滤掉已删除工作表的无效数据即可

可直接运行的代码 #

/**
 * 注册为Selection change触发器触发函数，自动持久化当前选区
 */
function cacheCurrentSelection(e) {
  const docProperties = PropertiesService.getDocumentProperties();
  const activeSheetName = e.range.getSheet().getName();
  // 从触发器事件对象直接拿选区，避免调用接口的活动表限制
  const selectedA1List = e.rangeList.getRanges().map(range => range.getA1Notation());
  // 更新缓存
  const allSavedSelections = JSON.parse(docProperties.getProperty('allSelections') || '{}');
  allSavedSelections[activeSheetName] = selectedA1List;
  docProperties.setProperty('allSelections', JSON.stringify(allSavedSelections));
}

/**
 * 获取所有工作表的选中范围，返回格式与预期一致
 */
function getAllSheetSelectedRanges() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const docProperties = PropertiesService.getDocumentProperties();
  const allSavedSelections = JSON.parse(docProperties.getProperty('allSelections') || '{}');
  const output = [];

  spreadsheet.getSheets().forEach(sheet => {
    const sheetName = sheet.getName();
    const sheetSelections = allSavedSelections[sheetName];
    if (!sheetSelections) return;
    sheetSelections.forEach(a1Notation => {
      const line = `${sheetName} ${a1Notation}`;
      output.push(line);
      console.log(line);
    })
  })

  return output;
}

• 插件首次安装时需要手动创建Selection change触发器绑定cacheCurrentSelection函数，授权后即可自动记录各表选区
• 缓存存储的是用户最后一次访问对应工作表时留下的选中范围，完全匹配多表选区留存场景
• 遍历数组类对象时使用forEach或for...of语法，不要用for...in遍历数组元素

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