VSCode如何给JSON文件添加注释 - JSONC格式切换与语法高亮支持教程

夏晨小哥_3114

夏晨小哥_3114

2026-03-27

866人浏览

原创

vscode默认不支持json文件注释,需切换为jsonc模式;可通过修改文件关联、设置files.associations或直接使用.jsonc后缀实现,但运行时需预处理为标准json。

vscode如何给json文件添加注释 - jsonc格式切换与语法高亮支持教程

VSCode 默认不支持 JSON 文件里的注释——不是你写错了,是标准 JSON 本来就不允许注释。想加 // 或 /* */,必须切换到 JSONC(JSON with Comments)模式,并确保文件后缀或语言模式正确识别。

怎么让 VSCode 把 .json 文件当 JSONC 解析

VSCode 不会自动把 .json 文件当作 JSONC 处理,哪怕里面写了注释也不会高亮或校验通过。关键在「语言模式」设置:

  • 打开任意 .json 文件 → 右下角点击当前语言标识(如 JSON)→ 点击「Configure File Association for '.json'」→ 选择 JSONC
  • 或者更稳妥:右键文件标签 → 「Change Language Mode」→ 输入 jsonc → 回车确认
  • 注意:这个设置只对当前工作区生效;若要全局生效,需在用户设置里修改 files.associations,添加 "*.json": "jsonc"

为什么改了语言模式还是报错“Comments are not permitted”

常见于两种情况:

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 你用的是严格 JSON 验证器(比如 ESLint 的 jsonc-eslint-parser 没配,或用了 json 而非 jsonc 解析器)
  • VSCode 的内置 JSON 校验仍启用 —— 进入设置搜 json.validate,关掉 JSON > Validate,或仅对 .jsonc 文件启用
  • 某些插件(如 Prettier)默认按 json 格式格式化,会删注释;需在 .prettierrc 中加 "parser": "json-stringify" 或改用 json5,但更推荐直接用 .jsonc 后缀区分

用 .jsonc 后缀比改关联更可靠吗

是的。VSCode 对 .jsonc 后缀有原生、无歧义的支持:

  • 新建文件时保存为 config.jsonc,语言模式自动设为 JSONC,注释高亮、折叠、语法检查全开
  • 不需要额外配置 files.associations,避免影响其他项目里真正的 JSON 文件
  • 但要注意:后端服务读取时可能不认 .jsonc —— 构建流程中得用工具(如 jsonc-parser 库)预处理成纯 JSON,不能直接扔给 JSON.parse()

真正容易被忽略的是:JSONC 是 VSCode 的编辑体验增强,不是标准升级。只要文件要交给其他系统解析,就得剥离注释——别指望运行时能吃下带 // 的内容。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2135

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3282

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1096

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3759

7

vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1395

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2952

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1989

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1727

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2607

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程