如何清理Google Apps Script全局空间且无需创建千行级.gs文件

1. 用命名空间对象拆分模块 #

每个.gs文件对应一个全局命名空间对象，把该文件内的所有函数挂载到这个对象上，全局仅暴露这个对象，避免零散函数污染。

示例（SheetUtils.gs）：

const SheetUtils = {
  // 获取活动表数据
  getActiveSheetData: function() {
    return SpreadsheetApp.getActiveSheet().getDataRange().getValues();
  },
  // 清空指定工作表
  clearSheet: function(sheetName) {
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName).clear();
  }
};

调用时直接用SheetUtils.getActiveSheetData()，所有工作表相关函数都归在SheetUtils下，易查找、不混乱。

2. 利用文件级作用域隐藏内部函数 #

GAS中，.gs文件里未挂载到全局对象的函数，仅在当前文件内可见。可以把辅助逻辑写成私有函数，只对外暴露核心功能：

示例（SheetUtils.gs）：

// 仅当前文件可用的私有辅助函数
function formatDate(date) {
  return Utilities.formatDate(date, Session.getScriptTimeZone(), "yyyy-MM-dd");
}

const SheetUtils = {
  // 对外暴露的方法，内部调用私有函数
  logSheetLastUpdated: function(sheetName) {
    const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
    const lastUpdated = sheet.getLastUpdated();
    console.log(`Sheet ${sheetName} last updated: ${formatDate(lastUpdated)}`);
  }
};

这样全局不会出现零散的辅助函数，只有命名空间对象暴露在外。

3. 用IIFE封装私有逻辑 #

立即执行函数表达式（IIFE）可以彻底隔离模块内部的变量和函数，仅对外暴露需要的接口，适合逻辑复杂的模块：

示例（ApiClient.gs）：

const ApiClient = (function() {
  // 私有常量，仅模块内部可见
  const BASE_URL = "https://api.example.com/v1";

  // 私有辅助函数
  function handleResponse(response) {
    if (!response.ok) {
      throw new Error(`API请求失败: ${response.getResponseCode()}`);
    }
    return response.getJson();
  }

  // 对外暴露的公共方法
  return {
    fetchUser: function(userId) {
      const url = `${BASE_URL}/users/${userId}`;
      const response = UrlFetchApp.fetch(url);
      return handleResponse(response);
    },
    createUser: function(userData) {
      const options = {
        method: "post",
        contentType: "application/json",
        payload: JSON.stringify(userData)
      };
      const response = UrlFetchApp.fetch(`${BASE_URL}/users`, options);
      return handleResponse(response);
    }
  };
})();

全局仅存在ApiClient一个对象，内部实现完全隐藏，不会污染全局空间。

4. 配合JSDoc增强代码补全 #

虽然GAS原生不支持模块式补全，但给命名空间和方法添加JSDoc注释，能让VS Code（配合clasp工具）提供准确的代码提示，避免重复开发：

示例：

/**
 * 工作表操作工具类
 * @namespace SheetUtils
 */
const SheetUtils = {
  /**
   * 获取当前激活工作表的所有数据
   * @returns {Array<Array<any>>} 二维数组格式的表数据
   */
  getActiveSheetData: function() {
    return SpreadsheetApp.getActiveSheet().getDataRange().getValues();
  }
};

输入SheetUtils.时，编辑器会自动提示可用方法及说明，不用再记函数名和功能。

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