.NET 6.0版C#开发的Outlook桌面加载项未显示在功能区

以下是针对迁移后加载项无法显示的具体排查方向，按优先级排序：

• 确认.NET 6桌面运行时已安装
  .NET 6分为多个运行时版本，加载项依赖Windows Desktop Runtime（不是ASP.NET Core Runtime）。检查目标机器是否安装：

  • 打开命令提示符运行 dotnet --info，查看输出中是否包含Microsoft.WindowsDesktop.App 6.x的条目；
  • 或者检查注册表路径 HKEY_LOCAL_MACHINE\SOFTWARE\dotnet\Setup\InstalledVersions\x64\sharedfx\Microsoft.WindowsDesktop.App（对应64位）或x86路径下是否有6.x版本的注册信息。

• 检查C++ Shim的.NET 6适配
  你的C++ Shim项目需要正确加载.NET 6运行时：

  • 确保Shim的目标平台（x86/x64）和其他所有项目完全一致；
  • 确认Shim中调用CLRCreateInstance时，指定了正确的.NET 6版本，或者使用兼容的方式加载最新可用的CLR；
  • 检查Shim项目是否正确引用了.NET 6的相关头文件和库，编译时没有报错。

• 验证注册表注册的准确性
  加载项的注册表项必须正确指向.NET 6编译后的程序集：

  • 定位到加载项的注册表路径（通常是HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\[你的加载项ID]），确认LoadBehavior值为3（表示启动时加载）；
  • 检查Manifest或Assembly字段的路径是否指向.NET 6编译后的输出文件，而非旧的.NET Framework版本路径；
  • 清理可能存在的旧版本残留注册项，避免Outlook混淆加载目标。

• 排查功能区XML的加载问题
  功能区无法显示可能是XML加载失败导致：

  • 确认功能区XML文件的属性设置为嵌入的资源，且命名空间路径正确；
  • 在加载项启动代码中添加日志，记录读取功能区资源的过程，排查是否有文件找不到或解析异常；
  • 适配.NET 6中资源读取的API变化，比如使用Assembly.GetManifestResourceStream时确保传入正确的资源名称。

• 利用Outlook内置诊断工具
  通过Outlook的加载项管理界面获取状态信息：

  1. 打开Outlook，点击文件->选项->加载项；
  2. 在底部管理下拉框选择COM加载项，点击转到；
  3. 查看你的加载项是否在列表中，状态是否为“已加载”。若显示加载失败，打开事件查看器（Windows日志->应用程序），查找Office相关的错误日志，里面会包含具体的失败原因。

• 确保目标平台完全一致
  Outlook的位数（32/64位）必须和加载项的编译平台一致：

  • 查看Outlook的版本信息（文件->Office账户->关于Outlook）确认位数；
  • 所有项目（WPF类库、Shim、WPF应用）的生成属性中，目标平台需设置为对应位数（x86或x64），避免因位数不匹配导致加载失败。

• 排查启动逻辑中的未处理异常
  加载项启动时的未处理异常会导致加载中断：

  • 在ThisAddIn_Startup或自定义启动方法中添加日志记录，输出关键步骤的执行状态；
  • 使用调试器附加到Outlook进程（Visual Studio中选择调试->附加到进程，找到OUTLOOK.EXE），逐步调试启动代码，定位是否有异常抛出。

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