切换为shared runtime后Excel Addin加载失败问题求助

故障原因及解决办法 #

1. 编译报错直接原因 #

你在taskpane.ts、commands.ts中调用的add、logMessage两个方法，定义在自定义函数脚本functions.ts中，没有做跨文件的引用或全局挂载，TypeScript编译时无法找到对应的方法声明，因此抛出未找到变量的错误。

2. 解决步骤 #

• 方法1：将需要跨场景调用的方法挂载到全局
  在functions.ts中添加全局声明和挂载逻辑：

// 扩展window全局类型声明，避免TS类型报错
declare global {
  interface Window {
    add: (a: number, b: number) => number;
    logMessage: (message: string) => void;
    // 如果你用到了按钮调用的action方法，也需要在这里声明
    action: (event: Office.AddinCommands.Event) => void;
  }
}

// 把你的方法挂载到window对象上
window.add = function add(a: number, b: number) {
  return a + b;
}
window.logMessage = function logMessage(message: string) {
  console.log(message);
}
// 按钮调用的action方法也需要挂载到全局
window.action = function action(event: Office.AddinCommands.Event) {
  // 你的按钮逻辑
  event.completed();
}

之后在taskpane.ts、commands.ts中调用这两个方法时，加上window.前缀即可：window.add(1,2)、window.logMessage("test")。

• 方法2：直接导入方法文件
  在taskpane.ts、commands.ts的顶部导入functions.ts：

import { add, logMessage } from "../functions/functions.ts";
// 注意替换为你实际的functions.ts文件路径

3. manifest配置补充检查 #

你当前的manifest配置已经符合共享运行时的基础要求，但需要确认两点：

• taskpane.html中已经正确引入了编译后的functions.js文件，否则运行时自定义函数、共享方法依然会找不到
• 按钮的ExecuteFunction调用的action方法必须挂载到全局window对象上，否则点击按钮会无响应

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