Outlook taskpane(officejs) addin开发后未在Ribbon显示问题

按以下优先级逐一排查，所有操作完成后重启Outlook验证：

• 首先校验manifest.xml配置兼容性
  Outlook 2016（MSI永久版）最高仅支持Mailbox 1.4要求集，即点即用版最低兼容要求集为1.4，若默认生成的manifest配置了更高版本要求集，Outlook会静默忽略加载项，不会出现在禁用/非活动列表。将Requirements节点替换为以下兼容配置：

  <Requirements>
    <Sets DefaultMinVersion="1.4">
      <Set Name="Mailbox" MinVersion="1.4" />
    </Sets>
  </Requirements>
  

  同时确认manifest中存在DesktopFormFactor对应的配置项，包含Ribbon按钮定义、taskpane入口地址，若仅配置了WebFormFactor或新Outlook适配项，旧版桌面端无法识别。另外检查所有XML节点的id属性，不能包含中文、特殊字符，不能重复，否则XML解析失败会直接跳过加载项。
• 手动完成旁加载注册
  office-addin-debug调试工具对Outlook 2016的自动旁加载存在已知bug，不会自动写入受信任加载项目录，需手动操作：
  1. 关闭所有Outlook进程，将manifest.xml所在的项目文件夹设置为本地共享，给Everyone账户分配读取权限
  2. 打开Outlook 2016，依次进入「文件」>「选项」>「信任中心」>「信任中心设置」>「受信任的加载项目录」
  3. 将共享文件夹的网络路径填入目录URL输入框，点击「添加」，勾选对应目录下方的「显示在菜单中」选项，保存设置
  4. 重启Outlook后，在「开始」选项卡的「所有加载项」>「自定义加载项」分类下即可找到对应插件，手动启用后会固定显示在Ribbon栏
• 排查运行环境依赖问题
  Outlook 2016使用IE11内核渲染Web加载项，且证书校验规则与新版Office不同：
  1. 在项目根目录执行npx office-addin-dev-certs install --machine，将开发自签名证书安装到本地计算机受信任根证书目录，不要仅安装到当前用户目录
  2. 打开IE浏览器（不要用Edge/Chrome）访问本地调试服务的taskpane地址，默认是https://localhost:3000/taskpane.html，确认没有证书报错、页面可以正常加载，否则Outlook会直接拦截加载项
  3. 确认当前Outlook配置的邮箱账户为Exchange、Microsoft 365或Outlook.com类型，POP/IMAP类型的第三方邮箱（如QQ邮箱、163邮箱）在Outlook 2016下不支持Web加载项，会完全隐藏加载项入口
• 清理损坏的加载项缓存
  之前加载失败的残留配置会导致Outlook持续跳过加载项：
  1. 关闭Outlook，打开注册表编辑器，定位到HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Outlook\Resiliency
  2. 删除该路径下的DisabledItems、CrashingAddinList子项
  3. 定位到HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Wef，删除所有键值中包含你manifest里<Id>节点对应GUID的子键
  4. 重新打开Outlook完成旁加载即可

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