Outlook桌面端add-in缓存机制、刷新逻辑及高效清理方法咨询

一、加载项缓存的实际运行逻辑 #

当前主流版本的Outlook桌面客户端（Microsoft 365/2021及后续版本）加载Web类加载项时，完全复用Edge WebView2 Runtime的能力，不存在独立于系统之外的专属缓存层，整个缓存流程分为两级：

• 元数据层缓存
  客户端会将加载项的Manifest配置、入口地址、权限信息存储在本地独立的隔离存储区域，默认的自然刷新周期为24小时。只有当管理员在Microsoft 365管理后台推送加载项的强制更新指令时，客户端才会主动触发元数据校验流程，否则不会主动向服务端确认Manifest版本。
• 静态资源层缓存
  加载项引用的HTML、JS、CSS等静态文件，完全遵循WebView2的通用HTTP缓存规则，会根据服务端返回的Cache-Control、ETag、Last-Modified响应头做磁盘持久化存储，这部分缓存不会因为Outlook重启、甚至计算机重启被自动清除，存储位置固定在用户目录下的WebView2专属存储路径中。

同部署环境下用户的行为差异原因完全来自本地缓存状态的不同：

• 可以直接看到新版本的用户，通常满足以下任意条件：本地静态资源缓存已自然过期、上次打开加载项时WebView2已自动完成资源校验拿到最新版本、客户端已接收到管理员下发的强制更新信号触发了全量缓存校验。
• 遭遇缓存不更新问题的用户，通常是本地存储的静态资源响应头设置了过长的缓存有效期，且未触发任何强校验逻辑，客户端会一直读取本地留存的旧资源，不会主动拉取新版本。

二、可调整的缓存策略配置 #

• 客户端侧可通过组策略/注册表调整缓存规则，配置路径为HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Outlook\Options\WebExtention：
  • 新建名为ManifestRefreshInterval的DWORD值，单位为分钟，可修改默认24小时的元数据刷新周期，比如设置为15即每15分钟主动校验一次Manifest版本。
  • 新建名为ForceWebViewCacheValidation的DWORD值，设置为1后，每次加载项启动时，WebView2会对所有静态资源发起强校验请求，不直接读取本地持久化缓存。
• 部署侧可通过管理后台配置更新策略，当推送新版本时选择“强制所有用户立即加载新版本”，该信号会实时下发到在线的Outlook客户端，触发客户端自动清除对应加载项的本地缓存标记，下次打开即可拉取全新资源。

三、轻量化缓存清理方法（无需使用Edge DevTools） #

• 调用Outlook原生清理入口：打开Outlook的「文件-选项-高级」，下拉到加载项配置区域，点击「清理已安装加载项的本地缓存」按钮，客户端会自动定位所有WebView2加载项的缓存路径，删除对应域名的缓存片段。
• 针对性删除单个加载项的缓存文件：直接在文件资源管理器打开%LOCALAPPDATA%\Microsoft\Office\16.0\WEF\路径，找到对应加载项域名命名的文件夹，直接删除整个目录，下次打开加载项时会重新拉取全部资源。
• 快捷启动参数重置：右键点击Outlook快捷方式，在目标路径末尾追加/resetaddin <对应加载项的ID值>参数，启动Outlook时会自动重置指定加载项的所有本地缓存，无需手动操作文件。

内容的提问来源于stack exchange，提问作者Terra-jin