Google Apps Script变量作用域及引用传递异常问题咨询

1. 全局代码重复执行问题 #

问题原因 #

Google Apps Script 的执行机制是：指定入口函数运行时，全局作用域的代码会先执行一次，随后再执行入口函数本身。你的示例中，全局作用域直接调用了myFn()，加上入口函数myFn()的执行，就导致In Function被重复打印。

解决方案 #

所有可执行逻辑必须放在函数内部，全局作用域仅用于声明变量或函数，不要编写直接执行的代码。调整后的代码示例：

function myFn() {
  Logger.log("In Function");
  Logger.log("In main"); // 把原全局的执行逻辑移到入口函数内
}

这样执行入口函数myFn()时，只会输出一次In Function和一次In main，避免重复执行。

2. 全局变量作用域问题 #

核心说明 #

Google Apps Script 中，全局变量的作用域覆盖整个脚本文件/项目，但需注意：

• 每次执行入口函数时，脚本会重新加载，全局变量会被重新初始化（若需跨执行会话保留值，需用PropertiesService存储）。
• 函数内部若声明了与全局变量同名的局部变量，会覆盖全局变量的访问。

解决方案 #

• 确保函数内部未声明同名局部变量，直接使用全局变量。
• 若需持久化存储变量值，使用PropertiesService（用户/文档/脚本属性）替代内存中的全局变量。

3. 数组/对象的引用传递与属性判断问题 #

3.1 数组添加键值对无效果的原因 #

JavaScript 中数组是特殊对象，但JSON.stringify()序列化数组时，仅处理数字索引属性，非数字键的属性会被忽略。你给数组myarr添加的testing属性实际存在于数组对象中，但JSON.stringify()不会输出它，导致误以为原数组未修改。

验证示例：

function testArrayProp() {
  var myarr = [];
  myarr["testing"] = "set in function";
  Logger.log(myarr.testing); // 输出 "set in function"
  Logger.log(JSON.stringify(myarr)); // 输出 []，非索引属性不被序列化
}

3.2 跨作用域修改的正确方式 #

如果需要用键值对存储数据，直接使用普通对象{}而非数组[]，数组仅用于有序的索引型数据。修改后的代码示例：

function byRefFn(myobj) {
  Logger.log("DEBUG: in byRefFn");
  myobj["testing"] = "set in byRefFn";
}

function byGlblFn() {
  Logger.log("DEBUG: in byGlblFn");
  myobj["testing"] = "set in byGlblFn";
}

function dummy() {}

var myobj = {}; // 用对象初始化
byRefFn(myobj);
Logger.log("DEBUG: myobj=" + JSON.stringify(myobj)); // 输出 {"testing":"set in byRefFn"}

byGlblFn();
Logger.log("DEBUG: myobj=" + JSON.stringify(myobj)); // 输出 {"testing":"set in byGlblFn"}

3.3 对象属性存在性的正确判断方法 #

你遇到的错误是因为myobj可能为null（typeof null返回'object'，单纯判断typeof无法排除null），正确的判断顺序如下：

// 方法1：先排除null，再用in运算符
if (myobj !== null && typeof myobj === 'object' && eventId in myobj) {
  // 执行逻辑
}

// 方法2：使用hasOwnProperty（需确保对象非null）
if (myobj !== null && typeof myobj === 'object' && myobj.hasOwnProperty(eventId)) {
  // 执行逻辑
}

// 方法3：使用Object.hasOwn（更安全，GAS支持）
if (myobj !== null && typeof myobj === 'object' && Object.hasOwn(myobj, eventId)) {
  // 执行逻辑
}

注意：Object.hasOwn()比hasOwnProperty()更安全，不会被对象自身的同名方法覆盖。

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