开发Word Web Add-in时功能区按钮图标不显示问题求助

我帮你梳理几个针对Windows版Word独有的排查方向，这类跨客户端的差异大多和Windows端的安全策略、资源加载机制有关：

• 检查图标格式与尺寸合规性：Windows版Word对功能区图标的要求比Online和Mac更严格，优先使用PNG格式（避免SVG，Windows端对SVG的支持有限），并且必须提供符合Office规范的多尺寸图标：16x16（常规DPI）、32x32（高DPI）、80x80（任务栏/启动器）。在manifest文件里通过<Icon>标签的不同<bt:Image>节点分别指定，示例代码如下：

<Icon>
  <bt:Image size="16" sourceLocation="https://your-server.com/icon-16.png" />
  <bt:Image size="32" sourceLocation="https://your-server.com/icon-32.png" />
  <bt:Image size="80" sourceLocation="https://your-server.com/icon-80.png" />
</Icon>

• 验证服务器证书与Office信任设置：Windows版Office依赖系统的证书信任存储，哪怕浏览器能访问图标，如果服务器用的是自签名证书或未被Windows信任的CA证书，Office会拒绝加载。你可以尝试将证书导入Windows的「受信任的根证书颁发机构」存储。另外检查Word的信任中心：打开Word → 文件 → 选项 → 信任中心 → 信任中心设置，确认是否允许加载外部网络资源，临时关闭「受保护的视图」中对Internet文件的保护（仅用于排查，排查后恢复）。

• 清除Office缓存：Windows版Word会缓存Add-in资源，旧缓存可能导致图标显示异常。关闭所有Office应用后，打开文件资源管理器输入%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\，删除该目录下的所有文件夹，再重启Word加载你的Add-in。

• 抓包分析资源请求：用Fiddler工具监控Windows版Word对图标的请求，查看是否有403、500等错误状态码，或者响应头是否异常。如果是跨域问题，需要在服务器配置允许Office相关域名的CORS访问，或者直接把图标放到和Add-in同域的服务器上。

• 尝试本地嵌入图标：如果外部URL加载始终有问题，把图标作为本地资源放到Add-in项目的images文件夹里，在manifest中用相对路径引用，比如sourceLocation="~/images/icon-16.png"，Windows端加载本地资源的稳定性会更高。

如果以上方法都无效，可以创建一个仅包含单个带图标按钮的最简测试Add-in，排除其他代码逻辑的干扰，确认是否是manifest配置或环境本身的问题。

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