使用Office JS开发MS Office插件时，代码变更需升级Manifest版本吗？

1. 版本号升级并非强制要求 #

日常代码迭代（比如功能微调、bug修复）时，只要插件的核心配置（如权限、入口URL、功能声明）没有变化，不需要每次都升级Manifest里的版本号。Manifest的核心作用是定义插件的元数据和Office的交互规则，仅更新网站上的代码文件，Office客户端会加载最新代码（前提是缓存机制处理得当）。

2. 需要升级版本号的场景 #

以下情况建议或必须升级Manifest版本号：

• 修改了Manifest中的核心配置：比如调整插件权限、变更入口URL、新增/移除功能模块、修改插件名称/描述等；
• 商店发布更新：若插件通过Office商店分发，提交新版本时必须升级版本号，这是商店的发布规范要求；
• 解决顽固缓存问题：当用户遇到缓存导致旧代码无法更新的情况时，升级版本号可触发Office客户端重新拉取插件元数据和资源，是强制刷新缓存的有效手段之一。

3. 缓存与安全问题的替代解决方案 #

不想升级版本号时，可通过以下方式处理缓存问题：

• 在静态资源（JS/CSS/图片）的文件名中添加哈希值（比如app.abc123.js），代码变更后文件名变化，浏览器会自动加载新资源；
• 在插件代码的响应头中配置Cache-Control: no-cache，强制客户端每次请求都验证资源有效性；
• 指导用户手动清除Office客户端的插件缓存：不同客户端（Windows/Mac/Web）有不同清理路径，比如Windows端可清理%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\目录下的缓存文件。

关于安全问题，版本号升级本身无法直接修复安全漏洞，需针对性修复代码中的安全问题（如输入验证、权限控制），若修复涉及Manifest的权限调整，才需要升级版本号并重新发布。

4. 用户无需反复重新添加插件 #

• 内部部署（侧加载）的插件：升级Manifest版本号后，用户无需重新添加，只需重新加载插件或重启Office客户端即可生效；
• Office商店分发的插件：升级版本号后，商店会自动推送给已安装用户，用户无需重新添加，仅会收到更新提示或后台自动完成更新。

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