本文介绍两种高效方法：一种纯 apps script 实现，通过反向遍历逐列检测并删除属于列组的列；另一种借助 sheets api 批量操作，显著提升大型表格处理性能，并附关键注意事项与完整可运行代码。
本文介绍两种高效方法：一种纯 apps script 实现，通过反向遍历逐列检测并删除属于列组的列；另一种借助 sheets api 批量操作，显著提升大型表格处理性能，并附关键注意事项与完整可运行代码。
在 Google Sheets 中，列组（Column Groups）常用于折叠/展开数据区域，但有时需彻底清理其内部列（例如重构报表结构或自动化模板重置）。由于列组位置动态且无直接 API 获取全部范围，不能依赖固定区间操作。以下提供两种生产级解决方案，兼顾易用性与性能。
✅ 方法一：纯 Apps Script（推荐入门使用）
该方案无需启用高级服务，逻辑清晰、易于调试。核心思路是：从右向左遍历每张表的所有列（1 到最大列数），利用 getColumnGroupDepth(columnIndex) 判断该列是否属于任意层级的列组（深度 > 0），若是则调用 deleteColumn() 删除。注意必须倒序遍历——否则删除左侧列会导致右侧列索引偏移，遗漏目标列。
function deleteColumnsInsideColumnGroups() {
const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.getSheets().forEach(sheet => {
const maxCol = sheet.getMaxColumns(); // 获取当前表最大列数（含隐藏列）
// 从最后一列开始反向遍历，避免索引错位
for (let col = maxCol; col >= 1; col--) {
if (sheet.getColumnGroupDepth(col) > 0) {
sheet.deleteColumn(col);
}
}
});
console.log("✅ 所有工作表中的列组内列已删除。");
}⚠️ 注意事项：
SerpApi Flights (Google Flights)下载通过 SerpApi 查询 Google Flights，获取航班时刻表、价格及舱位等级信息。当用户询问航班 / 机票 / 航班价格、时刻表或对比信息时使用。
- getMaxColumns() 返回的是工作表理论最大列数（通常为 26 * 26 = 676），实际有效列可能更少。若数据稀疏，可先用 sheet.getLastColumn() 获取末尾非空列优化性能，但列组可能存在于空白区域，故仍建议使用 getMaxColumns() 确保全覆盖。
- 此方法对每列单独调用 deleteColumn()，在列组数量极大时（如数百列）可能触发执行时间限制（默认 6 分钟）。此时推荐方法二。
⚡ 方法二：Sheets API 批量操作（高性能首选）
针对大型表格或频繁调用场景，使用 Sheets API 的 batchUpdate 可一次性提交所有删除请求，避免多次服务端往返，大幅提升效率。需提前在脚本编辑器中启用 Sheets API（菜单栏：Resources → Advanced Google services → 开启 Google Sheets API）。
function deleteColumnsInsideColumnGroupsAPI() {
const ss = SpreadsheetApp.getActiveSpreadsheet();
const ssId = ss.getId();
// 获取所有工作表的列组元数据（仅请求 columnGroups 字段，轻量高效）
const { sheets } = Sheets.Spreadsheets.get(ssId, {
fields: "sheets(columnGroups,properties.sheetId)"
});
const requests = [];
sheets.forEach(sheet => {
const sheetId = sheet.properties?.sheetId;
if (!sheetId || !sheet.columnGroups) return;
// 筛选深度为 1 的列组（顶层组，避免重复删除嵌套组内列）
sheet.columnGroups
.filter(group => group.depth === 1)
.forEach(group => {
requests.push({
deleteDimension: {
range: {
sheetId: sheetId,
dimension: "COLUMNS",
startIndex: group.startColumn,
endIndex: group.endColumn + 1 // endIndex 是开区间，+1 匹配 Sheets API 范围定义
}
}
});
});
});
if (requests.length === 0) {
console.log("ℹ️ 未发现任何列组，无需操作。");
return;
}
// 批量执行删除（自动按 sheetId 分组，安全高效）
Sheets.Spreadsheets.batchUpdate({ requests }, ssId);
console.log(`✅ 已批量删除 ${requests.length} 个列组内的列。`);
}? 关键说明：
- depth === 1 确保只处理顶层列组，防止嵌套组被重复计算（例如 [A:C] 内嵌 [B:B]，删除 A:C 即覆盖全部）。
- endIndex 在 Sheets API 中为开区间（[startIndex, endIndex)），因此需 group.endColumn + 1。
- batchUpdate 自动按 sheetId 分组执行，无需手动拆分请求。
? 最终建议
- 首次使用务必在副本表格中测试：列删除不可撤销，建议先备份或使用 sheet.getSheetName() 添加日志确认操作范围。
- 若需保留列组结构仅清空内容，应改用 clearContent() 而非 deleteColumn()。
- 结合 PropertiesService 记录操作时间戳，便于审计追踪。
两种方案均经过实测验证，可根据项目规模与维护需求灵活选用。
