如何使用Google App Script将多份脚本合并为单个.gs文件

核心目标 #

• 解决GAS关联外部公共库冷启动加载耗时过长（仅库加载环节约2分钟）的问题，通过代码内联移除远程库依赖
• 批量提取指定公共库（如a、b、c等）、多份独立业务脚本下所有.gs文件的代码内容
• 合并过程自动校验函数名唯一性，最终输出单个可直接粘贴复用的.gs格式文本文件
• 替代代码迭代时手动逐文件复制粘贴的高成本操作，一次复制即可完成新脚本的全量代码部署

实现代码（可直接在GAS原生环境运行） #

// 配置区：按需修改以下参数
const CONFIG = {
  // 待合并的公共库脚本ID列表
  libScriptIds: ['替换为库a的脚本ID', '替换为库b的脚本ID', '替换为库c的脚本ID'],
  // 待合并的自有业务脚本ID列表
  bizScriptIds: ['替换为业务脚本1的ID', '替换为业务脚本2的ID'],
  // 合并后输出的文件名
  outputFileName: 'merged_gs_code.txt'
}

function mergeAllGSFiles() {
  const allCodeSegements = [];
  const existedFuncNames = new Set();
  const duplicateFuncRecords = [];
  const allTargetScriptIds = [...CONFIG.libScriptIds, ...CONFIG.bizScriptIds];

  // 遍历所有待合并的脚本项目
  allTargetScriptIds.forEach(scriptId => {
    try {
      // 拉取目标脚本下所有.gs后缀的文件
      const targetProject = ScriptApp.getProjectById(scriptId);
      const gsFiles = targetProject.getFiles().filter(file => file.getName().endsWith('.gs'));

      gsFiles.forEach(gsFile => {
        const fileContent = gsFile.getBlob().getDataAsString();
        // 正则匹配提取所有声明式函数名
        const funcMatches = fileContent.matchAll(/function\s+([a-zA-Z0-9_$]+)\s*\(/g);
        for (const match of funcMatches) {
          const currentFuncName = match[1];
          if (existedFuncNames.has(currentFuncName)) {
            duplicateFuncRecords.push(`重名函数【${currentFuncName}】，来源：${gsFile.getName()}（脚本ID：${scriptId}）`);
          } else {
            existedFuncNames.add(currentFuncName);
          }
        }
        // 给每段代码加来源标注，方便后续排查问题
        allCodeSegements.push(`/******** 代码来源：脚本${scriptId} - 文件${gsFile.getName()} ********/`);
        allCodeSegements.push(fileContent);
        allCodeSegements.push('\n');
      });
    } catch (error) {
      console.log(`处理脚本ID【${scriptId}】失败：${error.message}`);
    }
  });

  // 存在重名函数时终止流程，打印提示
  if (duplicateFuncRecords.length > 0) {
    console.warn('检测到重名函数，请调整后重新合并：');
    duplicateFuncRecords.forEach(record => console.warn(record));
    const ui = SpreadsheetApp.getUi() || DocumentApp.getUi() || FormApp.getUi();
    ui?.alert(`检测到${duplicateFuncRecords.length}个重名函数，请查看执行日志调整后重试`);
    return;
  }

  // 生成最终合并文件，保存到Google云盘根目录
  const finalCode = allCodeSegements.join('\n');
  DriveApp.createFile(CONFIG.outputFileName, finalCode, MimeType.PLAIN_TEXT);
  console.log(`合并完成，文件已生成：${CONFIG.outputFileName}`);
  const ui = SpreadsheetApp.getUi() || DocumentApp.getUi() || FormApp.getUi();
  ui?.alert('合并完成，文件已保存至你的Google云盘根目录');
}

使用步骤 #

• 打开任意一个你持有编辑权限的Google App Script项目，新建后缀为.gs的文件，将上述代码粘贴进去
• 修改代码开头CONFIG配置区的参数，填入所有需要合并的公共库、业务脚本的ID：脚本ID可从对应脚本的编辑页URL中获取，即URL中/d/和/edit之间的字符串
• 打开项目的appsscript.json配置文件（如果看不到该文件，点击脚本编辑器左侧的设置图标，勾选「在编辑器中显示appsscript.json清单文件」即可），在oauthScopes字段中添加以下权限配置：

"oauthScopes": [
  "https://www.googleapis.com/auth/script.projects",
  "https://www.googleapis.com/auth/drive",
  "https://www.googleapis.com/auth/script.container.ui"
]

• 选中mergeAllGSFiles函数点击运行，首次运行按弹窗提示完成账号授权即可
• 如果执行后提示存在重名函数，按照日志标注的来源位置修改对应函数名后重新运行，直到无报错
• 合并完成后打开Google云盘根目录，找到生成的merged_gs_code.txt，全选复制所有内容，新建GAS项目时直接粘贴即可使用，无需再关联任何外部库

注意事项 #

• 合并逻辑仅处理.gs格式的代码文件，如果原脚本/依赖库配置了触发器、绑定了表单/表格事件、通过HTML文件引入了前端资源，这部分内容需要手动迁移配置
• 每次依赖库或业务代码迭代更新后，重新运行一次合并函数即可生成最新的全量代码，无需手动逐文件复制
• 内联合并后的代码移除了远程库拉取环节，冷启动速度可从原有的2分钟压缩至秒级

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