如何在Google Apps Script中部署新版本库以替换旧版本？

1. 先理清版本与部署的核心关系 #

Google Apps Script里的「版本」是脚本的静态快照，「部署」是对外提供访问的固定入口——库引用本质是关联部署ID，而非版本号。你之前的问题大概率是误操作新建了部署而非更新现有部署，导致旧部署仍被引用，新部署却因未关联现有引用被归档。

2. 关键操作：更新现有部署而非新建 #

要让所有引用项目自动切换到新版本，必须保留同一个部署ID，操作步骤如下：

• 打开你的库脚本，点击右上角「部署」→「管理部署」
• 在部署列表中找到当前被项目引用的活跃部署
• 点击该部署右侧的三个点→「编辑部署」
• 在「版本」下拉框中选择你修改后新建的脚本版本（若未创建新版本，先去「版本历史」页面生成）
• 其余设置保持不变，点击「部署」完成更新

完成后，所有引用该部署ID的项目会自动加载新版本，无需逐个修改版本号。

3. 避坑注意事项 #

• 禁止直接归档旧部署：一旦归档，旧部署ID失效，所有已引用项目会报错，只能重新替换部署ID
• 每次更新仅需替换现有部署关联的版本，无需新建部署
• 若已误归档旧部署，需将新部署的ID同步给所有引用项目替换；有批量需求的话，可编写脚本批量修改（前提是拥有所有项目的编辑权限）

4. 验证更新效果 #

• 找一个引用该库的项目，打开脚本编辑器的库设置，确认部署ID未变
• 运行项目中调用库函数的代码，检查是否执行了新版本的逻辑

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