如何在Google Apps Script中传递复杂对象作为函数参数

问题原因 #

你遇到的Sheet对象传递后变成字符串的问题，本质是Google Apps Script的原生服务对象（如Sheet、Spreadsheet）属于特殊包装对象，无法被序列化。如果是跨脚本上下文传递（比如客户端与服务端交互、触发器触发的独立函数调用），这类对象会被自动转换为字符串表示，导致无法访问属性和方法。

解决方案 #

根据你的调用场景，分两种情况处理：

1. 同服务端脚本上下文内调用（普通函数调用）

如果是在同一个脚本执行流程内调用函数（比如主函数调用子函数），直接传递Sheet对象是完全可行的，不需要额外处理：

function main() {
  var spreadSheet = SpreadsheetApp.getActive();
  var sheets = spreadSheet.getSheets();
  var startSheet = sheets[1];
  // 直接传递Sheet对象
  myDumbFunction(startSheet);
}

function myDumbFunction(sheet) {
  // 正常调用Sheet的属性和方法
  Logger.log("当前Sheet名称：" + sheet.getName());
  sheet.getRange("A1").setValue("测试内容");
}

2. 跨上下文传递（客户端交互、触发器等场景）

如果是跨上下文传递（比如通过HtmlService的网页调用服务端函数、定时触发器触发独立函数），需要传递Sheet的唯一可序列化标识，在目标函数中重新获取对象：

• 推荐传递Spreadsheet ID + Sheet名称（名称比索引更稳定，避免Sheet顺序调整导致错误）：

// 发起调用的函数
function init() {
  var spreadSheet = SpreadsheetApp.getActive();
  var startSheet = spreadSheet.getSheets()[1];
  // 传递可序列化的标识
  myDumbFunction(spreadSheet.getId(), startSheet.getName());
}

// 接收参数的函数
function myDumbFunction(spreadsheetId, sheetName) {
  // 通过标识重新获取Sheet对象
  var targetSheet = SpreadsheetApp.openById(spreadsheetId).getSheetByName(sheetName);
  // 正常操作Sheet
  targetSheet.getRange("B2").setValue("通过标识获取对象");
}

• 也可以传递索引（注意：若Sheet顺序调整，索引会失效）：

function init() {
  var spreadSheet = SpreadsheetApp.getActive();
  var sheetIndex = 1;
  myDumbFunction(spreadSheet.getId(), sheetIndex);
}

function myDumbFunction(spreadsheetId, sheetIndex) {
  var targetSheet = SpreadsheetApp.openById(spreadsheetId).getSheets()[sheetIndex];
  // 执行操作
}

内容的提问来源于stack exchange，提问作者Steffen Schön