这一档按严格 JSON 语法判,注释、单引号、末尾逗号都不合法。「JSON格式化」不支持 JSON5、带注释的 JSONC 与 YAML,也不做 Schema 校验。要过校验,得先把注释去掉。下面说清哪些写法会报错以及替代走法。

一、严格 JSON 和带注释格式的区别

「JSON格式化」是文档处理四个纯前端页之一,这一步在浏览器里完成,文件不离开本机,不用登录。

JSON 规范本身不支持任何注释语法。但实际开发中有些工具链把 JSON 扩展成允许注释的形式:JSONC 允许行注释和块注释,JSON5 进一步允许单引号、末尾逗号和无引号键名,YAML 用缩进和冒号表示结构、语法完全不同。这三种格式在编辑器里看着像 JSON,但拿到严格解析器面前都不合法。

这一页只接受标准 JSON。上述三种扩展格式统统不认。能做的事:按严格语法校验,给出行列定位和前后字符。不能做的事:不自动剥离注释、不支持 JSON5 和 JSONC、不做 Schema 校验。

二、哪些写法会在校验时报错

写法特征校验结果
行注释键值对后面跟两个斜杠加说明文字报错
块注释斜杠星号包住多行说明报错
单引号包字符串键名或值用单引号而不是双引号报错
末尾逗号最后一个元素后面多了一个逗号报错
标准写法双引号、无注释、无末尾逗号通过

校验报错时会给出行号和列号,定位到注释或非法字符所在位置。

三、去掉注释再校验的操作步骤

  1. 打开 JSON格式化 页。
  2. 粘贴文本前先手动删掉所有注释行和行尾注释。
  3. 检查有没有单引号和末尾逗号,全部改成标准双引号写法并删掉多余逗号。
  4. 点击「校验」确认语法通过。
  5. 通过后再点「美化」调整缩进。

四、替代处理思路

如果文本确实带注释且不想逐行手删,可以先在文本编辑器里用批量替换把注释行删掉,再贴回这一页校验。替换时注意行注释从斜杠开始删到行末,块注释删掉从斜杠星号到星号斜杠之间的整段内容。

如果数据是从 XML 格式转过来的,可以在 XML转换 页先转成 JSON,产物本身就是标准格式,不带注释。如果数据从表格文本转来,走 CSV转换 页选 JSON 输出形态,出来的结果同样合规。

五、常见问题

问:那带注释的配置项怎么校验?
答:这一页不处理带注释的格式。如果配置文件需要注释,考虑用 XML 格式存放,站内有「XML转换」页支持 XML 的校验和格式化。

问:把注释删掉就能过校验了吗?
答:注释删掉之后还要检查单引号和末尾逗号。这三类问题经常同时出现。校验通过的标准是全部用双引号、没有注释、没有末尾逗号。

问:能批量去掉注释吗?
答:这一页没有去注释功能,六个动作里不包含这一项。需要手动删或在文本编辑器里做批量替换。替换完之后记得重新点校验确认没有残留的非法字符。

问:手机上能用吗?
答:可以,手机浏览器直接打开这一页粘贴文本做校验,文件不离开本机,不用登录。

六、本站入口

这一步在「JSON格式化」页完成,文件不离开本机。校验通过后如果需要调整缩进或转成表格文本,用同一页的美化和转 CSV 动作处理。