如何在Apps Script中实现不同脚本文件间的引用调用

云原生阿岚

2026-8-28

Apps Script 同项目多文件调用实现方案

Google Apps Script 原生运行环境不支持 Node.js 生态的 ES Module（import/export）、CommonJS（module.exports/require）模块规范，直接使用这两种语法会直接抛出你遇到的两类报错：

ReferenceError: module is not defined：环境中不存在CommonJS规范对应的module全局对象
SyntaxError: Unexpected token 'export'：环境语法解析不支持ES模块的导出关键字

同一个Apps Script项目下的所有.gs、.js脚本文件默认共享同一个全局作用域，不需要手动编写导入语句，即可直接跨文件调用其他文件内声明的全局函数、全局变量。

与Node示例等效的写法

你给出的Node导入调用示例，在Apps Script中不需要写任何导入导出语句，按如下方式编写即可：

工具库文件直接声明全局函数，无需导出

// update-cell-1.gs
function updateCell1() {
   // 更新单元格1的业务逻辑
}

// update-cell-2.gs
function updateCell2() {
   // 更新单元格2的业务逻辑
}

主脚本文件直接调用目标函数，无需导入

// main.gs
function main() {
  updateCell1();
  updateCell2();
}

开发注意事项

禁止在不同文件中声明同名的全局函数、全局变量，否则会出现命名覆盖问题，运行时后加载的定义会覆盖先前的定义
项目文件较多时，建议通过全局对象模拟命名空间做逻辑隔离，避免命名冲突，示例：

// 单元格操作相关工具统一挂载到CellUtils全局对象
const CellUtils = CellUtils || {};
CellUtils.updateCell1 = function() {
  // 更新单元格1逻辑
}
CellUtils.updateCell2 = function() {
  // 更新单元格2逻辑
}

// 主文件调用
function main() {
  CellUtils.updateCell1();
  CellUtils.updateCell2();
}