如何验证 openapi 3.0.0 yaml 规范？答案

【问题标题】：How to validate openapi 3.0.0 yaml spec?如何验证 openapi 3.0.0 yaml 规范？
【发布时间】：2020-05-29 15:38:06
【问题描述】：

我有一个从 swagger 2.0 更新到 openapi 3.0.0 的 yaml 规范。

文件本身大约有 7,000 行，因此手动验证具有挑战性。

我需要弄清楚我拥有的哪些标签不再与 openapi 3.0.0 兼容。如何验证我的架构？有没有我可以使用的命令行工具？

我不想在线复制/粘贴此代码，因为我不想公开所有路由。

【问题讨论】：

【解决方案1】：

https://editor.swagger.io 在客户端执行验证，这意味着您的定义不会发送到任何地方。您也可以run the editor locally，例如离线。

注意事项：

https://openapi.tools 有一个OpenAPI validation tools 列表，包括命令行工具和 Node.js 模块。

【讨论】：

【解决方案2】：

在 Visual Studio 代码上使用 openapi-lint 扩展，并记住将文件命名为 *openapi.json, *openapi.yaml, *openapi.yml, *oas3.json, *oas3.yml, *oas3yaml。

【讨论】：