通过定义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 路径(支持相对路径)。
citySHOP是一款集CMS、网店、商品、系统,管理更加科学快速;全新Jquery前端引擎;智能缓存、图表化的数据分析,手机短信营销;各种礼包设置、搭配购买、关联等进一步加强用户体验;任何功能及设置都高度自定义;MVC架构模式,代码严禁、规范;商品推荐、促销、礼包、折扣、换购等多种设置模式;商品五级分类,可自由设置分类属性;商品展示页简介大方,清晰,图片自动放大,无需重开页面;商品评价、咨询分开
3. 查看智能提示效果
创建一个 myconfig.json 文件,输入内容时你会看到:
- 键名自动补全(如输入
"n"提示"name") - 字段描述悬浮显示
- 类型错误实时标红(如 version 不符合正则)
- 数组项也能提示字符串类型
如果字段有 default 值,在补全时也会作为建议出现。
4. 进阶技巧
- 使用
$ref拆分大型 Schema,便于维护 - 支持嵌套对象和复杂结构(如枚举、条件校验)
- 可引用远程 Schema(如放在 GitHub 或内部服务上)
- 配合
examples字段提供使用示例(部分编辑器支持)
基本上就这些。只要定义好 Schema 并正确关联,VSCode 就能为任意 JSON 配置提供专业级编辑体验,不复杂但容易忽略。









