自制VSTO Word加载项在Office 2019中无法显示求助

以下是针对你的情况的具体排查点和解决方案：

• 架构不匹配问题
  确认Office 2019的架构（32位/64位）和加载项的编译目标平台一致：

  1. 打开Word，依次点击「文件」>「账户」>「关于Word」，查看Office的架构版本。
  2. 在Visual Studio的项目属性中，切换到「生成」标签，检查「平台目标」是否和Office架构匹配（比如Office是64位，就选x64）。
  3. 手动检查注册表：加载项的注册项通常在HKEY_CURRENT_USER\Software\Microsoft\Office\Word\AddIns\[你的加载项ID]或对应64位的HKEY_LOCAL_MACHINE路径，确认LoadBehavior值为3（启动时加载），若为0或2则说明加载被禁用，手动修改为3后重启Word。

• VSTO运行时兼容性
  虽然你勾选了2010版VSTO运行时，但Office 2019可能需要更新的运行时版本。前往控制面板>程序和功能，确认已安装的VSTO运行时版本，若版本较旧，卸载后重新安装适配Office 2019的最新VSTO运行时。

• 加载项被Office自动禁用
  Office会在加载项启动失败一次后自动禁用它：

  1. 打开Word>「文件」>「选项」>「加载项」，在底部「管理」下拉菜单选择「COM加载项」，点击「转到」，查看你的加载项是否在列表中，若未勾选则手动勾选并重启Word。
  2. 同样在加载项设置中，「管理」下拉选「禁用项目」，点击「转到」，若你的加载项在列表中，选中后点击「启用」。

• 权限导致的加载失败
  如果安装程序使用管理员权限安装，但Word以普通用户身份运行，可能无法读取HKLM下的注册项：

  • 尝试以管理员身份运行Word，若加载项正常显示，说明是权限问题。可以将加载项的注册路径调整到HKCU（当前用户），或者给普通用户赋予对应注册表项的读取权限。

• 项目部署的Office兼容性设置
  在Visual Studio的发布设置中，检查是否指定了过高的最低Office版本支持。确保发布配置中兼容的Office版本包含2019或更低版本，避免因版本限制导致加载项被Office拒绝。

• 加载项启动异常排查
  在加载项的ThisAddIn_Startup方法中添加日志记录，确认加载项是否真正启动：

  private void ThisAddIn_Startup(object sender, System.EventArgs e)
  {
      string logPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Desktop), "addin_startup.log");
      File.WriteAllText(logPath, "加载项启动成功，时间：" + DateTime.Now.ToString());
  }
  

  重新发布安装后，在目标电脑上运行Word，查看桌面是否生成日志文件。如果没有日志，说明加载项未触发启动，需重点排查注册和架构问题；如果有日志但加载项仍不显示，说明是UI组件创建或后续逻辑存在异常。

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