这一档按严格 JSON 语法判,注释、单引号、末尾逗号都不合法。「JSON格式化」不支持 JSON5、带注释的 JSONC 与 YAML,也不做 Schema 校验。要过校验,得先把注释去掉。下面说清哪些写法会报错以及替代走法。
一、严格 JSON 和带注释格式的区别
「JSON格式化」是文档处理四个纯前端页之一,这一步在浏览器里完成,文件不离开本机,不用登录。
JSON 规范本身不支持任何注释语法。但实际开发中有些工具链把 JSON 扩展成允许注释的形式:JSONC 允许行注释和块注释,JSON5 进一步允许单引号、末尾逗号和无引号键名,YAML 用缩进和冒号表示结构、语法完全不同。这三种格式在编辑器里看着像 JSON,但拿到严格解析器面前都不合法。
这一页只接受标准 JSON。上述三种扩展格式统统不认。能做的事:按严格语法校验,给出行列定位和前后字符。不能做的事:不自动剥离注释、不支持 JSON5 和 JSONC、不做 Schema 校验。
二、哪些写法会在校验时报错
| 写法 | 特征 | 校验结果 |
|---|---|---|
| 行注释 | 键值对后面跟两个斜杠加说明文字 | 报错 |
| 块注释 | 斜杠星号包住多行说明 | 报错 |
| 单引号包字符串 | 键名或值用单引号而不是双引号 | 报错 |
| 末尾逗号 | 最后一个元素后面多了一个逗号 | 报错 |
| 标准写法 | 双引号、无注释、无末尾逗号 | 通过 |
校验报错时会给出行号和列号,定位到注释或非法字符所在位置。
三、去掉注释再校验的操作步骤
- 打开 JSON格式化 页。
- 粘贴文本前先手动删掉所有注释行和行尾注释。
- 检查有没有单引号和末尾逗号,全部改成标准双引号写法并删掉多余逗号。
- 点击「校验」确认语法通过。
- 通过后再点「美化」调整缩进。
四、替代处理思路
如果文本确实带注释且不想逐行手删,可以先在文本编辑器里用批量替换把注释行删掉,再贴回这一页校验。替换时注意行注释从斜杠开始删到行末,块注释删掉从斜杠星号到星号斜杠之间的整段内容。
如果数据是从 XML 格式转过来的,可以在 XML转换 页先转成 JSON,产物本身就是标准格式,不带注释。如果数据从表格文本转来,走 CSV转换 页选 JSON 输出形态,出来的结果同样合规。
五、常见问题
问:那带注释的配置项怎么校验?
答:这一页不处理带注释的格式。如果配置文件需要注释,考虑用 XML 格式存放,站内有「XML转换」页支持 XML 的校验和格式化。
问:把注释删掉就能过校验了吗?
答:注释删掉之后还要检查单引号和末尾逗号。这三类问题经常同时出现。校验通过的标准是全部用双引号、没有注释、没有末尾逗号。
问:能批量去掉注释吗?
答:这一页没有去注释功能,六个动作里不包含这一项。需要手动删或在文本编辑器里做批量替换。替换完之后记得重新点校验确认没有残留的非法字符。
问:手机上能用吗?
答:可以,手机浏览器直接打开这一页粘贴文本做校验,文件不离开本机,不用登录。
六、本站入口
这一步在「JSON格式化」页完成,文件不离开本机。校验通过后如果需要调整缩进或转成表格文本,用同一页的美化和转 CSV 动作处理。