Excel加载项启用/禁用功能区按钮报ControlIdNotFound错误

以下是对应报错的排查和解决方法：

• 检查共享运行时配置：这是ribbon动态更新的前置要求，必须在manifest中配置共享运行时，否则Office无法识别自定义控件的更新请求，会直接抛出ID找不到的错误。
• 核对ID大小写和拼写：Office对manifest中的ID匹配是完全大小写敏感的，不要手动输入ID，直接从manifest配置中复制TabHome、CommandsGroup、AddNewBAButton三个ID粘贴到代码中，避免大小写、拼写偏差。
• 确认调用时机：必须等待Office.onReady()完全执行完成、插件激活之后再调用Office.ribbon.requestUpdate方法，如果在插件初始化未完成时就触发更新，Office还未加载完整的ribbon配置，就会找不到对应控件。
• 清除旧manifest缓存：如果修改过manifest的ID配置，需要清空Office的加载项缓存，重新旁加载最新的manifest，避免旧配置残留导致ID不匹配：
  1. 打开Excel选项-信任中心-信任中心设置-受信任的加载项目录
  2. 删除旧的本地加载项目录，重新添加最新的目录
  3. 重启Excel后重新旁加载插件测试
• 缩小排查范围：可以先尝试仅更新Group的enabled属性，如果更新Group不报错，则问题出在按钮ID的匹配上；如果更新Group也报错，则问题出在Tab或Group的ID匹配上，逐步缩小排查范围。

你可以参考调整后的调用逻辑：

// 所有更新ribbon的操作必须确保在Office初始化完成后执行
Office.onReady(() => {
  // 触发disableAddNewBAButton的逻辑放在这里，或者确保在初始化完成后调用
});

function disableAddNewBAButton() {
  try {
    const ribbonUpdater = {
      tabs: [
        {
          id: "TabHome", // 直接从manifest复制的ID
          groups: [
            {
              id: "CommandsGroup", // 直接从manifest复制的ID
              controls: [
                {
                  id: "AddNewBAButton", // 直接从manifest复制的ID
                  enabled: false
                }
              ]
            }
          ]
        }
      ]
    };
    Office.ribbon.requestUpdate(ribbonUpdater);
    addNewBAButtonEnabled = false;
    console.log(addNewBAButtonEnabled);
  } catch (error) {
    console.log("Disable Add New BA Button Error:" + error.stack);
  }
}

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