错误处理

我们将在 2023 年晚些时候停用助手功能，但您仍然可以使用旧版本的 Sketch 或命令行界面。 了解更多

助手生成的错误通常会在 Sketch 应用程序中捕获并显示。通过在用户界面中显示错误，故障会变得更加明显和可修复。本指南介绍您可能会遇到的场景以及您可能希望自己抛出错误的原因。

💡 虽然 Sketch 不会隐藏错误，但您可能会发现使用 NodeJS 调试和修复问题更容易 - 请阅读我们的 运行和测试 指南以了解操作方法。

助手可能会遇到两种类型的错误：规则错误，它可以与助手结果同时存在；一般错误，在无法生成结果时出现。

规则错误

规则错误是在调用规则函数期间捕获的。我们不会将这些错误视为严重故障，并在助手结果旁边显示它们。

遇到规则错误的原因可能包括：

• 您已从规则中故意抛出错误，例如 示例 当选项不是正确的数据类型时。
• 您的规则运行时间过长，已超时。
• 您的规则逻辑中抛出了其他意外错误。

遇到规则错误时，Sketch 将在结果表中规则下方显示无法检查整个文档消息。您可以单击消息右侧的小图标，将错误详细信息复制到剪贴板。

一般错误

一般错误可能更严重，可能意味着您的助手根本无法生成任何结果。与规则错误一样，这些错误也会在 Sketch 应用程序中显示以供查看。

遇到一般错误的一个原因可能是您的助手在 Sketch 预期格式中构建不正确。如果您最初遵循了我们的 入门 指南，那么您应该拥有一个基于 Sketch 助手模板 的工作构建流程，因此值得将您的项目与模板存储库进行比较，看看您的设置是否有所偏离或需要更新。

如果发生一般错误，Sketch 将用错误显示替换您的助手结果。

😵 如果您遇到不理解的其他错误，或者怀疑某些内容运行不正常，请在 sketch-assistants 存储库中提出问题 - 我们很乐意提供帮助！