google apps script 不支持原生 enum，但可通过 getter 属性、数组映射或 object.fromentries 动态生成有序常量对象，避免手动维护数字索引，显著提升 spreadsheet 列管理的可读性与健壮性。
google apps script 不支持原生 enum，但可通过 getter 属性、数组映射或 object.fromentries 动态生成有序常量对象，避免手动维护数字索引，显著提升 spreadsheet 列管理的可读性与健壮性。
在 Google Apps Script 开发中，尤其是处理 Google Sheets 时，为列名（如 FIRST_NAME、EMAIL、PHONE）定义清晰、稳定的索引常量是提高代码可维护性的关键。然而，硬编码每个数值（如 FIRST_NAME: 1, LAST_NAME: 2, ADDRESS: 3）不仅易出错，而且在插入新列时需逐个调整后续值，违背“单一来源真相”原则。
幸运的是，JavaScript 提供多种优雅方式模拟类枚举行为。以下三种方案按适用场景递进推荐：
✅ 方案一：使用 get 访问器（推荐用于少量、逻辑关联的常量）
const COLUMNS_INDEXES = {
FIRST_NAME: 1,
get NICKNAME() { return this.FIRST_NAME + 1; },
get LAST_NAME() { return this.NICKNAME + 1; },
get ADDRESS() { return this.LAST_NAME + 1; },
};
// 使用示例
console.log(COLUMNS_INDEXES.FIRST_NAME); // → 1
console.log(COLUMNS_INDEXES.ADDRESS); // → 4✅ 优势：语义清晰、顺序依赖显式、支持 IDE 智能提示（部分编辑器可识别 getter）；
⚠️ 注意：JSON.stringify() 会正常序列化计算结果（如 {FIRST_NAME:1,NICKNAME:2,...}），但不可用于 Object.keys() 遍历时获取 getter 属性（因其非自有可枚举属性）；若需完整枚举列表，请配合 Object.getOwnPropertyNames() 或改用方案二/三。
✅ 方案二：基于数组顺序自动生成（推荐用于线性、无分支的列序列）
const COLUMN_NAMES = ['FIRST_NAME', 'NICKNAME', 'LAST_NAME', 'ADDRESS'];
const COLUMNS_INDEXES = COLUMN_NAMES.reduce((obj, name, index) => {
obj[name] = index + 1; // 列索引从 1 开始（Sheet 列号惯例）
return obj;
}, {});
// 或更现代写法（ES2019+）
const COLUMNS_INDEXES = Object.fromEntries(
COLUMN_NAMES.map((name, i) => [name, i + 1])
);✅ 优势：完全声明式、零重复、插入/重排只需修改 COLUMN_NAMES 数组；天然支持 for...of、.map() 等数组操作；
? 扩展建议：可将 COLUMN_NAMES 提取为配置常量，甚至从首行标题动态读取（sheet.getRange(1, 1, 1, lastColumn).getValues()[0][0]），实现真正“列名即索引”的自动化映射。
⚠️ 补充说明：为什么 LAST_NAME: FIRST_NAME + 1 会报错？
直接在对象字面量中引用同级属性（如 LAST_NAME: FIRST_NAME + 1）会导致 ReferenceError，因为对象字面量初始化时各属性处于独立作用域，无法跨键访问——这是 JavaScript 语法限制，而非 GAS 特有。getter 或函数式构造正是为此类依赖关系而设计的合规解法。
? 最佳实践总结
- 对固定顺序且可能新增/移动的列（如表头结构），优先采用 方案二（Object.fromEntries），兼顾简洁性与可维护性；
- 对含业务逻辑的分组常量（如状态码 PENDING: 0, APPROVED: PENDING + 1），选用 方案一（getter） 更具表达力；
- 避免使用 var 或全局污染，始终用 const 声明，并置于脚本顶部或独立配置模块中；
- 在实际 Sheet 操作中，结合 sheet.getRange(2, COLUMNS_INDEXES.FIRST_NAME, lastRow, 1) 等调用，让代码自解释、抗重构。
通过以上方法，你不仅能摆脱“改一个、漏十个”的索引维护噩梦，更能构建出随业务演进而自然伸缩的健壮数据层——这才是专业 GAS 开发应有的起点。
立即学习“Java免费学习笔记（深入）”；
