集中部署Excel加载项后Ribbon功能区按钮不显示问题求助

排查方向 #

• 检查Manifest的<Resources>节点配置：你所有控件引用的resid（包括TaskpaneButton.Label、AutoFillButton.Label等文本资源，Icon.16x16等图标资源，Taskpane.Url、FunctionFile对应的资源id）必须全部在<Resources>节点内有对应且路径正确的定义，任意资源缺失都会导致Ribbon渲染失败，且该错误不会在任务窗格侧抛出。
• 检查<FunctionFile>节点配置：你有两个按钮使用ExecuteFunction类型的Action，Manifest中必须正确配置<FunctionFile>节点且其指向的HTML文件路径可正常访问，该配置缺失/路径错误会直接导致整个自定义Ribbon组不显示，和功能是否实际调用无关。
• 检查Ribbon层级结构：确认三个<Control>节点都放在合法的<Group>节点下，Group节点被正确放入自定义Tab或者内置Tab的ExtensionPoint中，所有Tab、Group的id无重复、无和Office内置id冲突的情况。
• 最小化验证兼容问题：临时注释掉两个ExecuteFunction类型的按钮，仅保留ShowTaskpane类型的按钮重新打包发布测试，如果单个按钮可正常显示，可定位问题出在Function相关配置或者当前Office版本对执行函数类按钮的兼容性上。
• 清空本地Office加载项缓存：Office会缓存加载项Manifest，管理中心更新版本后本地可能仍调用旧配置，删除路径C:\Users\[你的系统用户名]\AppData\Local\Microsoft\Office\16.0\Wef下的所有缓存文件，重启Excel后重新添加加载项测试。
• 验证Azure Storage静态资源规则：确认Azure静态网站的CORS配置允许Office客户端域名访问所有静态资源，避免图标、FunctionFile等资源被跨域拦截导致Ribbon渲染失败。

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