本文介绍在 google apps script 中，如何根据列标题名称而非固定索引，从二维数据数组中动态提取任意列组合，实现灵活、可维护的报表生成逻辑。

本文介绍在 google apps script 中，如何根据列标题名称而非固定索引，从二维数据数组中动态提取任意列组合，实现灵活、可维护的报表生成逻辑。

在处理来自 Google Sheets 的结构化数据时，硬编码列索引（如 row[1]、row[36]）虽能快速实现功能，但极易因表头调整而失效。当报表需求变为“每周列组合不同，但列名始终存在”时，必须转向基于列名的动态列提取方案。

核心思路是：先定位列名对应的实际索引，再按索引批量取值。具体分两步：

1. 获取表头并映射列名 → 列索引
   读取第一行作为表头，用 indexOf() 查找目标列名的位置：

   const colHeaders = ["Full Name", "EID", "Email - Work", "Management Level"];
   const sheetHeaders = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0]; // 更安全：[0] 替代 flat()
   const colIndices = colHeaders.map(header => {
     const idx = sheetHeaders.indexOf(header);
     if (idx === -1) throw new Error(`列名 "${header}" 未在表头中找到`);
     return idx;
   });

2. 对每行数据，按索引序列提取对应列值
   使用嵌套 map：外层遍历数据行，内层遍历列索引数组，构建新行：

   const data = sheet.getRange(2, 1, sheet.getLastRow() - 1, sheet.getLastColumn()).getValues();
   const result = data.map(row => colIndices.map(idx => row[idx]));

✅ 优势说明：

• 列顺序完全由 colHeaders 数组定义，增删改仅需修改该数组；
• 表头位置变动（如插入新列）自动适配，无需更新索引数字；
• 错误防护：显式检查列名是否存在，避免静默返回 undefined。

⚠️ 注意事项：

• sheetHeaders.indexOf() 区分大小写且要求完全匹配，建议统一表头格式或使用 trim() + toLowerCase() 预处理；
• 若存在重复列名，indexOf() 始终返回首个匹配项索引，应确保列名唯一；
• getValues() 返回的是二维数组（即使单行），推荐用 [0] 获取首行，比 flat() 更语义清晰且兼容性更好。

最终，你获得的是一个结构稳定、语义明确、易于配置的动态列提取流程——让报表逻辑真正跟随业务变化，而非被 Excel 表格牵着走。