如何调试Outlook外接程序并在桌面端Outlook中正确加载运行？

1. 前置配置检查 #

• 确认Outlook版本：需为Microsoft 365订阅版、Office 2021及以上版本，低版本不支持现代外接程序的旁加载功能
• 开启旁加载权限：打开Outlook → 「文件」→「选项」→「信任中心」→「信任中心设置」→「受信任的加载项目录」，勾选允许旁加载的自定义加载项，开发环境下可临时勾选允许加载不受信任的加载项避免权限拦截
• 安装本地信任证书：Yeoman生成的项目默认自带自签名证书，执行npx office-addin-dev-certs install完成安装，避免Outlook拦截本地HTTPS开发服务

2. 正确旁加载外接程序（避免加载后消失） #

你之前手动加载manifest属于临时会话模式，关闭Outlook就会自动清除，需用官方开发工具注册加载项：

• 先启动本地开发服务：执行npm run dev-server，确认服务正常启动，且manifest文件中<SourceLocation>节点的URL和本地开发服务地址完全一致
• 在项目根目录执行注册命令：npx office-addin-debugging start [你的manifest文件名] desktop，例：如果你的manifest文件是manifest.xml，就执行npx office-addin-debugging start manifest.xml desktop，该命令会自动将加载项注册到本地Office的受信任列表，不会随窗口关闭消失

3. 任务窗格不弹出解决方法 #

npm start默认不会自动弹出任务窗格，需手动触发：

• 注册完成后打开Outlook，新建一封空白邮件，打开撰写界面
• 顶部功能区会出现你开发的外接程序的功能按钮，点击按钮即可呼出任务窗格，后续打开撰写窗口时会保留窗格的开启状态
• 如果功能区没有出现按钮，检查manifest中ExtensionPoint配置是否为MessageComposeCommandSurface（撰写邮件场景的扩展点），确认按钮ID、动作地址没有拼写错误

4. 桌面端调试方法 #

Windows端Outlook目前使用Edge WebView2作为运行时，打开Edge浏览器访问edge://inspect即可找到外接程序的运行进程，点击inspect即可进入调试界面，操作和浏览器调试完全一致；Mac端可通过Safari开发菜单中的Web检查器找到外接程序进程调试。

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