使 yaml-language-server 验证 OpenAPI 嵌套架构

Question

yaml-language-server

具有称为“嵌套架构引用”的功能，它允许您使用 URL 片段引用嵌套架构定义。 遗憾的是，我无法从

Open API 规范

中验证嵌套架构。

例如，我希望 yamlls 验证存储在与主

yamlls

不同的文件中的参数对象。

openapi.yaml这不起作用，

# yaml-language-server: $schema=https://github.com/OAI/OpenAPI-Specification/raw/main/schemas/v3.1/schema.json#/$defs/parameter
name: token
in: header
description: token to be passed as a header
required: true
schema:
  type: array
  items:
    type: integer
    format: int64
style: simple

只是使用根架构（即 Open API 架构）验证文档。

如果有人能帮助我理解为什么这不起作用并且可能为我提供替代方案，那就太好了。

我能够让它像这样工作：

Answer 1

yamlls

版本，因为您使用的 uri 返回 html 表示形式，而不是原始 json 或 yaml 文件

raw

# yaml-language-server: $schema=https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.json#/$defs/parameter

name: test
in: headers
schema:
  type: string
required: true