调试 Office 加载项实质上与调试任何 Web 应用程序相同。 但是,一组工具不适用于所有加载项开发人员。 这是因为加载项可以在不同的操作系统上开发并跨平台运行。 本文可帮助你找到开发环境的详细调试指南。
本文关注的是狭义上的调试,即设置断点和单步执行代码。 有关测试和故障排除的指南,请从
测试 Office 加载项
和
使用 Office 加载项排查开发错误
开始。
尽管应在要支持的所有平台上
测试
加载项,但在不同于开发计算机的环境中,你只需要进行
调试
。 因此,本文使用“开发计算机”和“你的开发环境”来表示要进行调试的环境。 如果代码中的问题仅发生在开发计算机以外的平台上,并且需要设置断点或单步执行代码来解决该问题,则进行调试的环境并不是你的开发环境。
服务器端还是客户端?
调试 Office 加载项的服务器端代码与调试任何 Web 应用程序的服务器端相同。 请参阅 IDE 或其他工具的调试说明。 下面是一些最常用工具的示例。
在 Visual Studio 中调试 ASP.NET 或 ASP.NET Core 应用
调试 Express
Node.js 调试指南
VS Code 中的 Node.js 调试
Webpack 调试
本文的其余部分仅涉及调试客户端 JavaScript(可从 TypeScript 转译)。
在某些特殊情况下,对于给定的平台、Office 应用程序和开发环境组合,调试过程不同于正常情况。 如果要调试这些特殊情况中的任何一种,请使用本部分中的链接来查找适当的指南。 否则,请继续使用
常规指南
。
调试
Office.initialize
或
Office.onReady
函数
:
调试 initialize 和 onReady 函数
。
在
非共享
运行时中调试 Excel 自定义函数
:
非共享运行时中的自定义函数调试
。
在
非共享
运行时中调试
函数命令
: