Spectral

Spectral 是一个强调 OpenAPI 和 AsyncAPI 的 JSON/YAML 代码静态检查工具（linter）。在设计和实现 API 或进行事件驱动的协作时，它所提供的全面且开箱即用的规则可以帮助开发者省去很多麻烦。 这些规则可以用于检查 API 参数规范或规范中存在的许可声明等。其 CLI 能够让本地开发和 CI/CD 流水线中更容易地引入 Spectral，而 JavaScript API 则支持更高级的使用场景。它的 GitHub 页面 链接了一些公开的真实公司（比如 Adidas）正在使用的规则集，这使得团队在采用他们自己的检查规则时有了一个良好的开始。

我们在本期技术雷达中反复看到的一种模式是，当一种新的语言变得流行以后，静态错误和样式检查工具会迅速浮现出来。这些工具通常被称作linters——以经典且深受欢迎的可以静态分析C代码的Unix工具 lint命名。我们喜欢这些工具，因为它们会更早捕获异常，甚至在代码未编译之前。这个模式最新的例子是关于YAML和JSON的linter Spectral。尽管Spectral可用作这些文件格式的通用检查工具，但它的主要目标是OpenAPI（Swagger和AsyncAPI的演化版本）。Spectral为这些规范提供了全面的开箱即用的规则，帮助开发者们在设计和实现API或事件驱动协作中避免麻烦。这些规则可以检查API参数规范或者规范中存在的许可声明等。虽然这个工具成为API开发工作流中广受欢迎的补充，它仍然提出了一个问题：即非执行文件的规范是否应该如此复杂，以至于需要为编程语言设计专门的错误检查技术。也许开发者们应该写的是代码而非规范？