首次运行Outlook Web Add-in遇到无法加载显示问题求助

优先排查核心前提 #

• 确认你登录Outlook的是个人微软账户，企业工作账户如果被管理员禁用外接程序权限、本地离线账户、本地部署的Exchange账户都会直接导致外接程序相关功能被锁，Get Add-ins按钮默认灰化
• 不要在Outlook主界面找任务窗格按钮，Yeoman生成的默认插件仅在邮件撰写/阅读场景生效，你需要先打开一封新邮件的撰写窗口，再在顶部功能区找插件入口

清单文件校验（你修改过清单，优先排查这里） #

• 确认<Requirements>节点声明的Mailbox API版本不高于你Outlook版本支持的上限：Outlook 2016最低支持Mailbox 1.5，365桌面端支持最新版本，声明过高版本会导致插件被自动隐藏
• 确认<VersionOverrides>节点下所有资源地址（任务页、图标、命令地址）都和你本地启动的服务地址https://localhost:3000完全匹配，端口、协议不要写错
• 确认插件ID、版本号没有和你本地之前安装的其他测试插件重复

手动旁加载方案（绕过灰化的Get Add-ins按钮） #

• 先信任本地开发SSL证书，避免Outlook拦截不安全的本地服务：进入项目根目录，执行npx office-addin-dev-certs install，按照弹窗提示完成证书信任
• 用PowerShell直接加载插件：以管理员身份打开PowerShell，依次执行以下命令：
  1. 允许本地脚本运行：Set-ExecutionPolicy RemoteSigned，弹出提示时输入Y确认
  2. 加载你的插件清单：Add-AppxPackage -Register "替换为你的项目根目录绝对路径\manifest.xml"
  3. 完全关闭Outlook进程后重启，打开邮件撰写窗口即可看到插件按钮

替代测试方案 #

如果桌面端一直调试不通，可以先用Outlook网页版测试，网页版的外接程序限制远少于桌面端，先跑通基础逻辑再排查桌面端适配问题。

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