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

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 文件

这个方法不依赖任何插件，也不修改语法定义，但需要你手动控制注释位置——容易漏行或错位，仅适合紧急场景。

真正麻烦的从来不是“怎么加注释”，而是“加完之后谁来保证它不被格式化工具吃掉、不被校验器报错、不被下游系统拒绝”。JSONC 是目前最平衡的选择，但得全程盯住语法标识和插件开关，漏一个环节，注释就变成 bug 温床。