通过定义JSON Schema并关联到配置文件，可在VSCode中实现智能提示。1. 创建描述结构的Schema文件，定义字段类型、必填项、默认值和校验规则；2. 将Schema放入.vscode/schemas/目录按文件名自动匹配，或在settings.json中通过json.schemas手动映射fileMatch与url；3. 编辑JSON时即可获得自动补全、悬停提示、错误校验等提示；4. 支持拆分Schema、嵌套结构、远程引用及示例填充，提升复杂配置编辑体验。
在 VSCode 中为自定义 JSON 配置文件添加智能提示，可以通过关联 JSON Schema 实现自动补全、悬停提示和错误校验。这对于团队协作或复杂配置非常实用。
1. 创建 JSON Schema 文件
要让 VSCode 识别你的配置结构，先定义一个描述数据结构的 Schema 文件（如 myconfig.schema.json）：
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "项目名称"
},
"version": {
"type": "string",
"pattern": "^\d+\.\d+\.\d+$",
"description": "版本号，格式为 x.x.x"
},
"enabled": {
"type": "boolean",
"default": true
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "标签列表"
}
},
"required": ["name", "version"]
}
这个 Schema 定义了字段类型、是否必填、默认值以及正则校验规则。
2. 在 VSCode 中绑定 Schema 到配置文件
有几种方式将 Schema 关联到你的 JSON 文件：
-
通过文件路径自动匹配：把 Schema 放在
.vscode/schemas/目录下，并命名成目标文件名加后缀，例如：.vscode/schemas/myconfig.schema.json对应myconfig.json，VSCode 会自动识别。 -
手动设置文件关联：打开 VSCode 设置（
settings.json），添加文件模式映射：
"json.schemas": [
{
"fileMatch": ["myconfig.json"],
"url": "./.vscode/schemas/myconfig.schema.json"
}
]
其中 fileMatch 是触发提示的文件名或路径模式，url 指向本地 Schema 路径（支持相对路径）。
3. 查看智能提示效果
创建一个 myconfig.json 文件，输入内容时你会看到：
- 键名自动补全（如输入
"n"提示"name"） - 字段描述悬浮显示
- 类型错误实时标红（如 version 不符合正则）
- 数组项也能提示字符串类型
如果字段有 default 值，在补全时也会作为建议出现。
4. 进阶技巧
- 使用
$ref拆分大型 Schema，便于维护 - 支持嵌套对象和复杂结构（如枚举、条件校验）
- 可引用远程 Schema（如放在 GitHub 或内部服务上）
- 配合
examples字段提供使用示例（部分编辑器支持）
基本上就这些。只要定义好 Schema 并正确关联，VSCode 就能为任意 JSON 配置提供专业级编辑体验，不复杂但容易忽略。
