Outlook JS API与Outlook REST API的关联及本地联系人获取疑问

这问题我当初刚接触Office加载项开发时也懵过，来给你捋清楚二者的关系和核心疑问：

一、Office JS API和Outlook REST API的关联 #

Office JS API是一套客户端侧的开发接口，专门用来在Outlook（网页版、桌面版、移动端）里构建加载项。它本身提供了一些轻量的本地操作能力，但很多涉及到跨邮件、全局联系人/日历数据的功能，底层其实是封装调用了Outlook REST API（现在更多是基于Microsoft Graph API）。简单说：

• Office JS是你写加载项时直接调用的“门面”API，帮你处理和Outlook客户端的交互逻辑；
• Outlook REST API是后端服务接口，负责从Exchange/Microsoft 365云端拉取或写入完整的账户数据。

二、关于离线本地联系人的疑问 #

你提到的“本地离线联系人”需要分两种情况看：

1. 同步过的本地缓存联系人：Outlook桌面版默认会把云端账户的联系人同步到本地缓存，哪怕你处于离线状态，Office JS API调用相关功能时，其实是读取本地缓存的同步数据，而这个数据本质还是来自云端（之前同步过），所以文档里会提到依赖REST API——因为数据的源头是云端，缓存只是本地副本。
2. 纯本地PST文件里的联系人：如果你用的是完全没有绑定云端账户的本地PST，那Office JS API确实无法直接访问这类数据。因为Office JS的设计是基于云端账户的数据模型，纯本地离线的PST数据不在它的访问权限范围内，这种场景下确实没办法通过官方API获取到。

三、使用Office JS API是否必须数据在线？ #

不是所有场景都需要在线：

• 不需要在线的场景：比如修改当前打开邮件的主题、插入正文内容、添加附件这类针对当前邮件的本地操作，Office JS API可以直接在客户端完成，不需要调用REST服务。
• 需要依赖云端/缓存的场景：比如获取全局联系人列表、读取日历事件、搜索历史邮件这类跨数据的操作，Office JS会调用REST API（或读取本地缓存的云端数据），这时候需要数据已经同步到云端，或者客户端有缓存好的离线副本——如果完全离线且从未同步过云端数据，这类操作就会失败。

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