Excel Desktop中OfficeJS加载项启动行为失效问题求助

针对你遇到的Angular开发的OfficeJS Excel加载项在Desktop端无法自动加载的问题，可按以下步骤排查解决：

1. 确认Shared Runtime配置完全符合Desktop要求 #

确保manifest.xml中Shared Runtime的配置没有遗漏：

• 必须声明Runtime类型为shared，并指定正确的资源路径（对应Angular的index.html）：

  <Runtime resid="Taskpane.Url" type="shared" />
  

• 权限需至少设置为ReadWriteDocument：

  <Permissions>ReadWriteDocument</Permissions>
  

• 确保Host节点包含桌面端支持：

  <Hosts>
    <Host Name="Workbook" />
  </Hosts>
  

• 自定义命令与任务窗格必须共用同一个Runtime，即所有功能的指向资源需一致。

2. 调整启动行为的设置时机 #

不要在用户点击命令后才设置启动行为，需在Shared Runtime初始化阶段（Office就绪时）执行设置，确保持久化生效：
在Angular的根组件（比如app.component.ts）中，在ngOnInit里完成Office就绪检查后立即设置：

async ngOnInit() {
  await Office.onReady();
  // 检查并设置启动行为
  const currentBehavior = await Office.addin.getStartupBehavior();
  if (currentBehavior !== Office.StartupBehavior.load) {
    await Office.addin.setStartupBehavior(Office.StartupBehavior.load);
  }
  // 此处编写文档打开时需自动执行的业务代码
}

Desktop端要求启动行为的设置必须在加载项初始化阶段完成，而非用户触发命令后，否则无法在下次文档打开时生效。

3. 验证Excel Desktop版本与加载项状态 #

• 确认使用的Excel Desktop是支持Shared Runtime的版本：需为Excel 2019及以上，或者Microsoft 365订阅的最新版本，旧版本不支持自动加载特性。
• 检查加载项是否被禁用：打开Excel选项→加载项→COM加载项，确认你的加载项处于启用状态；同时在信任中心确认允许加载项自动运行。

4. 测试持久化设置是否生效 #

设置启动行为后，关闭所有Excel实例，重新打开文档，通过以下代码验证设置是否被持久化：

async checkStartupBehavior() {
  const behavior = await Office.addin.getStartupBehavior();
  console.log(behavior); // 若显示"Load"则设置成功
}

若仍不生效，可尝试重新安装加载项（删除侧加载的加载项后重新导入manifest）。

参考官方《在文档打开时运行代码》指南中的Shared Runtime相关要求进行配置。

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