咨询：是否有OfficeScript实现Excel连接REST API的入门教程

阿华AIGC实验室

2026-5-9

嘿，我太懂你这种需求转换的痛点了——之前靠VBA+ADO在Windows端Excel连Azure SQL玩得溜，但现在要转到全平台通用的Office Scripts，还得通过API来做数据查询和更新，却找不到合适的入门资源对吧？下面给你整理几个实打实的入门方向，都是不用跳外链就能上手的：

Office Scripts 对接 Azure SQL API 入门指南

先搞定Office Scripts基础语法
先从Excel自带的脚本编辑器入手：打开Excel（网页端/桌面端都可以），点「自动化」→「新建脚本」，默认的示例脚本会教你怎么读写单元格、遍历数据。Office Scripts基于TypeScript，语法和JavaScript很像，上手门槛不高，先把基础的工作表操作练熟。

掌握API调用核心：fetch函数
Office Scripts里用fetch来发送HTTP请求，这是对接你API的核心。入门可以先写个简单的测试：

async function main(workbook: ExcelScript.Workbook) {
  // 发送GET请求到你的测试API
  const response = await fetch("你的API地址");
  const data = await response.json();
  // 把返回的数据写到A1单元格
  workbook.getActiveWorksheet().getRange("A1").setValue(JSON.stringify(data));
}

先跑通这个流程，理解请求、响应、数据解析的基本逻辑。

针对Azure SQL的查询与更新操作
假设你已经有能操作Azure SQL的API（你说不用搭建指导，这里就默认API就绪）：
- 数据查询：发送GET请求到查询API，拿到JSON格式的结果后，用Range.setValues()把数据批量写入工作表，比如把查询到的表格数据写入指定区域。
- 数据更新：从Excel里读取需要修改的数据，整理成API要求的JSON结构，用fetch发送POST/PUT请求，记得在请求头里设置Content-Type: application/json，然后根据响应结果给用户反馈（比如用console.log或者写入单元格提示）。
身份验证与错误处理
如果你的API用Azure AD验证，Office Scripts可以用OfficeRuntime.auth.getAccessToken()获取访问令牌，加到请求头里：
```
const token = await OfficeRuntime.auth.getAccessToken();
const response = await fetch("你的API地址", {
  headers: {
    "Authorization": `Bearer ${token}`
  }
});
```
另外一定要加try-catch块处理请求失败的情况，比如网络问题、API返回错误，避免脚本直接崩溃。
利用官方内置示例
打开脚本编辑器后，点「示例」标签，里面有不少现成的「从外部数据源获取数据」「发送API请求」的案例，你可以直接修改这些示例来适配自己的API，比从零开始写快很多。