本文详解如何使用 google apps script 快速隐藏或显示指定的非连续列（如财务模型中的“forecast”或“actuals”列），无需调用 sheets api，兼容按钮触发，代码简洁可靠。
本文详解如何使用 google apps script 快速隐藏或显示指定的非连续列（如财务模型中的“forecast”或“actuals”列），无需调用 sheets api，兼容按钮触发，代码简洁可靠。
在构建财务预测与实际对比报表时，常见布局为交替排列的列结构（例如：A列=Jan Forecast、B列=Jan Actual、C列=Feb Forecast、D列=Feb Actual……）。为提升可读性，常需一键仅显示 Forecast 列（隐藏所有 Actual 列），或反之。由于这些目标列在表格中不连续（如 Forecast 列可能为第1、3、5、7…列），无法通过 hideColumns(start, end) 等连续范围方法实现——必须针对每个列号单独操作。
幸运的是，Google Apps Script 提供了简单高效的原生方法：sheet.hideColumn(range) 和 sheet.unhideColumn(range)。它们接受单列 Range 对象（如 sheet.getRange(1, colIndex)），完美支持非连续列控制，且无需启用高级 API 权限，避免了 batchUpdate 带来的授权复杂性和语法错误风险（如原问题中因 sheetName 未加引号、API 未启用导致的“could not save”错误）。
以下是一个可直接部署的通用脚本模板，已适配您的场景：
function showForecastColumns() {
// ✅ 定义所有 Forecast 列号（示例：第1、3、5、7...列；请按实际调整）
const forecastCols = [1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23];
// ❌ 定义所有 Actual 列号（即需隐藏的列）
const actualCols = [2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24];
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data"); // ? 替换为你的工作表名称
// 隐藏所有 Actual 列
actualCols.forEach(col => sheet.hideColumn(sheet.getRange(1, col)));
// 显示所有 Forecast 列（确保即使之前被隐藏也能恢复可见）
forecastCols.forEach(col => sheet.unhideColumn(sheet.getRange(1, col)));
}
function showActualColumns() {
const actualCols = [2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24];
const forecastCols = [1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23];
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
// 隐藏所有 Forecast 列
forecastCols.forEach(col => sheet.hideColumn(sheet.getRange(1, col)));
// 显示所有 Actual 列
actualCols.forEach(col => sheet.unhideColumn(sheet.getRange(1, col)));
}? 关键注意事项：
- 列号从1开始计数：getRange(1, col) 中 col 是整数列号（非字母），如第12列对应 col = 12；
- 务必替换 getSheetByName("Data") 中的 "Data" 为你的实际工作表名（如 "Budget Q1"），否则脚本将找不到目标表；
- 首次运行前需授权：点击菜单栏 Extensions > Apps Script → 粘贴代码 → 点击 ▶️ 运行一次 showForecastColumns，按提示授权（仅需一次）；
- 绑定到按钮：在 Sheets 中插入绘图（插入 > 绘图），右键绘图 → “分配脚本”，分别填入 showForecastColumns 或 showActualColumns；
- 性能提示：该方法对数百列仍高效；若需极致性能（如超千列），可改用 batchUpdate，但需启用 Sheets API 并严格校验 JSON 结构——对绝大多数财务报表场景，上述原生方法更安全、易维护。
✅ 总结：摒弃复杂 API 调用，善用 hideColumn() / unhideColumn() 配合数组遍历，即可优雅解决非连续列显隐需求。两个函数相互独立、逻辑清晰，便于扩展（如增加“重置全部列”功能），是自动化财务仪表板的实用基石。
