Sublime Text 中 JSON 注释支持的配置方式-sublime-PHP中文网

Sublime Text原生不支持JSON注释，因RFC 8259标准禁止注释且JSON语法未定义comment规则；唯一安全方案是切换为JSONC语法并配合SublimeLinter-jsonc插件，否则Ctrl+/无效或引发解析错误。

sublime text 中 json 注释支持的配置方式

Sublime Text 原生不支持 JSON 注释，强行加 // 或 /* */ 会导致解析失败；唯一安全方案是切换到 JSONC 语法并配对插件，否则所有“注释”都是假象。

为什么 Ctrl+/ 在 .json 文件里加不了注释

JSON 标准（RFC 8259）明确禁止注释，Sublime 的 JSON 语法定义里根本没写 comment_line_start 或 comment_block_start 规则。右下角显示 JSON 时按 Ctrl+/，要么没反应，要么乱插符号（比如在行首加 #），这不是快捷键坏了，是语法根本不认。

常见错误现象：

按 Ctrl+/ 后出现 # 或 //，但保存后 JSON 解析器报错
文件右下角显示 Plain Text 或 JavaScript，误以为“能注释”其实是语法识别错了
装了 Pretty JSON 或 JsFormat，结果把 null 转成字符串、删掉反斜杠，污染原始数据

用 JSONC 语法 + SublimeLinter-jsonc 实现真注释

JSONC（JSON with Comments）是 VS Code 等工具广泛采用的非标但实用的扩展格式，Sublime 需靠插件支持。关键不是“让 JSON 支持注释”，而是“告诉 Sublime：这文件是 JSONC，按另一套规则处理”。

操作步骤：

安装 SublimeLinter-jsonc 插件（不是 SublimeLinter-json）：按 Ctrl+Shift+P → Package Control: Install Package → 搜 SublimeLinter-jsonc
手动切换语法：点击右下角状态栏 → Set Syntax: JSONC（若没有该选项，需先安装 JSONC 语法包，如 JSONC Syntax）
确保校验生效：在 Preferences → Package Settings → SublimeLinter → Settings 用户配置中加入：
```
{
  "linters": {
    "jsonc": {
      "selector": "source.jsonc"
    }
  }
}
```

此时 Ctrl+/ 才会正确插入 // 行注释，且 SublimeLinter-jsonc 能识别并忽略它们——这才是带注释的合法工作流。

Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

JSONC 文件的格式化与保存风险

即使启用了 JSONC 语法，原生 JSON Reindent 和多数格式化插件仍会把它当普通 JSON 处理，删注释、改引号、加尾随逗号，导致注释丢失或结构破坏。

安全做法：

别用 JSON Reindent 处理 .jsonc 文件——它不识别注释，会直接删掉整行
HTML-CSS-JS Prettify 可以支持 JSONC，但必须在设置中显式开启：
```
"json": true,
"jsonc": true
```
（注意：部分旧版插件无 jsonc 开关，需升级）
保存前务必确认右下角是 JSONC，不是 JSON——两者 scope 不同，插件行为完全隔离
如果项目要交付给其他系统（如后端 API），注释必须人工删除或用脚本清理，不能依赖编辑器自动剥离

临时注释的保底方案：切语法 + 列模式

当 JSONC 不可用、插件冲突、或只是一次性调试，最稳的方式是绕过语法限制：

先按 Ctrl+Shift+P → 输入 Set Syntax: JavaScript，让 Ctrl+/ 生效（JS 支持 //）
选中要注释的多行，按住 Alt（Win/Linux）或 Option（macOS），鼠标从第一行开头拖到最后一行目标列位置，松开后在每行相同列插入 //
完成后记得切回 JSON 或 JSONC 语法，避免误保存为 JS 文件