Google App Script AutoSort函数如何应用到多个选中工作表

需求说明 #

需要实现的功能：工作表中包含新录入条目在内的所有整行数据，可按日期列自动执行升序排序。
现有问题：编写的AutoSort脚本仅能在单个GSheet标签页生效，无法应用到其他选中的工作表标签。
原有参考代码如下：

SHEET_NAME = "Sheet1";
SORT_DATA_RANGE = "A2:Z";
SORT_ORDER = [
{column: 3, ascending: true}, // 3 = 列号，按升序排序  
// {column: 3, ascending: false}, // 3 = 列号，按降序排序  
];


// 排序完成后弹出提示
function onEdit(e){
  multiSortColumns();
}
function multiSortColumns(){
  var ss = SpreadsheetApp.getActiveSpreadsheet(); 
  var sheet = ss.getSheetByName(SHEET_NAME);
  var range = sheet.getRange(SORT_DATA_RANGE);
  range.sort(SORT_ORDER);
  ss.toast('排序操作已执行。');
}

失效原因 #

原代码硬编码了固定工作表名Sheet1，执行逻辑只会定向操作名称匹配的单个工作表，不会识别当前正在编辑的其他标签页，因此无法在多标签场景下生效。

调整后代码 #

// 配置项：填写需要启用自动排序的工作表名称，留空数组[]则对所有工作表生效
const ENABLED_SHEET_NAMES = [];
// 排序数据范围：默认从第2行（跳过表头）覆盖到Z列，可根据实际数据列数调整
const SORT_DATA_RANGE = "A2:Z";
// 排序规则：默认按第3列（C列，即日期列）升序排序，可按需修改列号
const SORT_ORDER = [
  {column: 3, ascending: true},
  // {column: 3, ascending: false}, // 如需降序排序，注释上行、打开本行即可
];

function onEdit(e) {
  // 异常兜底，避免手动执行脚本时报错
  if (!e?.range) return;
  const currentSheet = e.range.getSheet();
  const ss = SpreadsheetApp.getActiveSpreadsheet();

  // 白名单校验：如果配置了指定生效的工作表，非列表内工作表不执行排序
  if (ENABLED_SHEET_NAMES.length && !ENABLED_SHEET_NAMES.includes(currentSheet.getName())) {
    return;
  }

  // 对当前编辑的工作表执行排序
  const sortRange = currentSheet.getRange(SORT_DATA_RANGE);
  sortRange.sort(SORT_ORDER);
  ss.toast(`工作表「${currentSheet.getName()}」自动排序完成`);
}

使用说明 #

• 若需要仅对指定标签页生效，将目标标签名填入ENABLED_SHEET_NAMES数组即可，示例：const ENABLED_SHEET_NAMES = ["订单表", "访客记录"];
• 若日期列不在C列，修改SORT_ORDER中column对应的数值即可，列号从A列开始计数，A=1、B=2、C=3以此类推
• 若数据列数超过Z列，直接修改SORT_DATA_RANGE的终止列即可，例如数据到AC列则填写"A2:AC"

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