Google Apps Script如何定义仅在指定.GS文件内生效的变量

Google Apps Script中所有.gs文件的顶层代码默认共享全局作用域，要实现文件级私有变量，我们可以用立即执行函数（IIFE）为每个文件创建独立的局部作用域，需要对外暴露的触发器/按钮绑定函数挂载到全局对象即可，既可以实现单文件内变量共享，也不会出现跨文件同名变量冲突问题。

Boys.gs 改造示例 #

// Boys.gs 全部内容放在这个IIFE内部即可
(function () {
  // 以下变量仅在当前Boys.gs文件内生效，不会和其他文件的同名变量冲突
  const app = SpreadsheetApp;
  const activeSheet = app.getActiveSpreadsheet();
  const sheetBoys = activeSheet.getSheetByName('Boys');
  // 如果需要固定脚本加载时的取值就用getValue()，需要保留Range对象可以直接写getRange('B7')
  const classID = sheetBoys.getRange('B7').getValue();

  // 文件内部不需要对外暴露的工具函数直接定义即可，可直接调用classID
  function calculateBoyScore() {
    console.log(classID);
  }

  // 需要绑定触发器、表格按钮的函数，挂载到全局对象上
  globalThis.onEditBoys = function (e) {
    calculateBoyScore();
    // 原有OnEdit触发器逻辑
  }
  globalThis.addNewBoy = function () {
    // 原有按钮绑定的逻辑
    console.log('当前班级ID：' + classID);
  }
})();

Girls.gs 改造示例 #

// Girls.gs 全部内容放在这个IIFE内部即可
(function () {
  // 以下变量仅在当前Girls.gs文件内生效，和Boys.gs的同名变量完全隔离
  const app = SpreadsheetApp;
  const activeSheet = app.getActiveSpreadsheet();
  const sheetGirls = activeSheet.getSheetByName('Girls');
  const classID = sheetGirls.getRange('B9').getValue();

  function calculateGirlScore() {
    console.log(classID);
  }

  // 对外暴露的触发器/按钮函数
  globalThis.onEditGirls = function (e) {
    calculateGirlScore();
    // 原有OnEdit触发器逻辑
  }
  globalThis.addNewGirl = function () {
    // 原有按钮绑定的逻辑
    console.log('当前班级ID：' + classID);
  }
})();

补充说明 #

• 触发器、表格按钮绑定时，直接选择挂载到globalThis上的函数名即可（比如onEditBoys、addNewBoy），原有功能完全不受影响。
• 如果B7/B9单元格的内容会动态更新，不想脚本加载时就固定取值，可以把classID改成动态获取的方法：

  // 替换原有classID定义，调用时用getClassID()即可拿到最新的单元格值
  const getClassID = () => sheetBoys.getRange('B7').getValue();
  

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