如何将自研Excel Add-in应用于Google Sheet？求操作方法及文档

核心背景 #

Excel Add-in基于Office JavaScript API，而Google Sheet的插件体系主要依赖Google Apps Script (GAS) 或Google Workspace Add-ons，二者架构差异较大，需要针对性适配。

具体迁移步骤 #

1. 功能拆解与API适配 #

先把原Excel Add-in的功能模块拆分，逐一替换为Google Sheet对应的API能力：

• 数据读写：原Excel.run()相关逻辑，替换为GAS的SpreadsheetApp类方法，比如getActiveSpreadsheet()获取工作表、getRange()定位单元格、setValue()/getValues()读写数据
• UI交互：原Office JS的任务窗格/对话框，改用GAS的HtmlService生成自定义网页界面，或用Workspace Add-ons的卡片式界面
• 事件触发：原Excel的onSelectionChanged等事件，替换为GAS的可安装触发器（如onEdit、onOpen，支持自定义触发条件）

2. 代码重构示例 #

以读取选中单元格值为例：
原Excel Add-in代码：

await Excel.run(async (context) => {
  const range = context.workbook.getSelectedRange();
  range.load('values');
  await context.sync();
  console.log(range.values[0][0]);
});

迁移到GAS后的代码：

function getSelectedCellValue() {
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const selectedRange = activeSheet.getActiveRange();
  console.log(selectedRange.getValue());
}

3. 部署与测试 #

• 普通绑定脚本（快速落地）：打开目标Google Sheet，点击「扩展程序 > Apps Script」，粘贴重构后的代码，保存后直接在脚本编辑器中测试，可通过「部署 > 部署为网页应用」或自定义工作表菜单（用onOpen添加菜单）供用户调用
• Workspace Add-ons（正式插件）：在GAS编辑器中配置appsscript.json清单文件，定义插件的入口、权限、界面布局等，然后通过「部署 > 部署为Workspace Add-on」完成部署，内部使用可跳过公开审核流程

官方参考资料 #

• Google Apps Script 电子表格开发指南：可搜索该关键词，涵盖数据操作、UI创建、触发器配置的完整说明
• Google Workspace Add-ons 开发入门：搜索该关键词，包含插件架构、清单配置、审核部署的全流程文档

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