JSON Schema子模式所有属性显示问题：编辑器支持还是Schema限制？

我有如下JSON Schema：

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "http://example.com/schemas/example",
    "type": "object",
    "title": "example service",
    "properties": {
        "dependencies": {
            "type": "array",
            "required": [
                "items"
            ],
            "minItems": 1,
            "items": {
                "anyOf": [{
                        "$ref": "#/definitions/resource1"
                    },
                    {
                        "$ref": "#/definitions/another_resource"
                    }
                ]
            }
        }
    },
    "definitions": {
        "resource1": {
            "additionalProperties": false,
            "type": "object",
            "properties": {
                "requiredProperty": {
                    "type": "string",
                    "enum": [
                        "requiredValue"
                    ]
                },
                "notRequiredProperty": {
                    "type": "string"
                },
                "required": [
                    "requiredProperty"
                ]
            }
        }
    }
}

在代码编辑器中，当我添加以下内容时，系统提示可选择自动填充所有必填属性，这一点很实用。但我希望找到让用户查看所有可用属性的方法，疑惑这是代码编辑器的功能限制，还是JSON Schema本身不支持该需求？

dependencies:
  - type: requiredValue

解答 #

首先明确：JSON Schema本身完全支持定义并暴露所有可用属性，你的问题主要来自两方面：Schema的语法错误，以及编辑器对Schema的解析/提示配置。

1. 修正你的JSON Schema语法错误 #

你的resource1定义里，required数组被错误地放在了properties内部，这会导致编辑器无法正确识别必填属性的范围，更不用说可选属性了。正确的写法应该是让required和properties同级：

"resource1": {
    "additionalProperties": false,
    "type": "object",
    "properties": {
        "requiredProperty": {
            "type": "string",
            "enum": [
                "requiredValue"
            ]
        },
        "notRequiredProperty": {
            "type": "string"
        }
    },
    "required": [
        "requiredProperty"
    ]
}

2. 检查编辑器的Schema支持配置 #

• 关联Schema到目标文件：确保编辑器知道当前编辑的文件要使用你定义的Schema。比如在VS Code中，可以通过文件顶部的注释（// $schema: ./your-schema.json）或者在settings.json里配置json.schemas关联规则，让编辑器精准加载你的Schema。
• 处理anyOf的识别问题：部分编辑器对anyOf的分支识别不够智能，无法同时展示多个分支的所有属性。你可以尝试暂时用oneOf替代，或者在编辑时明确指定要使用的Schema分支（比如先输入符合resource1特征的内容，触发编辑器识别对应的Schema定义）。
• 开启可选属性提示：有些编辑器默认只优先提示必填属性，需要手动开启显示可选属性的设置。比如VS Code可以检查json.suggest.showAllSymbols等相关配置，确保没有过滤可选属性。

3. 编辑器功能差异 #

不同编辑器对JSON Schema的支持程度有差异，部分轻量编辑器可能只实现了基础的必填属性提示，没有完整支持可选属性的展示。如果是这种情况，建议换用对JSON Schema支持更完善的编辑器（比如VS Code、JetBrains系列IDE）。

内容的提问来源于stack exchange，提问作者Kia Martinez