vscode 的 settings.json 不支持注释，因 json 标准禁止注释，强行添加会导致解析失败、配置失效；唯一安全方式是改用 settings.jsonc 文件名启用 jsonc 模式，支持 // 和 / / 注释，但需 vscode ≥1.60 且禁用设置 ui 编辑。
VSCode 的配置文件（settings.json）本身不支持注释语法，直接写 // 或 /* */ 会导致 JSON 解析失败、设置失效，这是硬性限制，不是插件能绕过的。
为什么 settings.json 里加 // 注释会报错
JSON 标准（RFC 8259）明确不支持注释。VSCode 的配置系统基于严格 JSON 解析，遇到 // TODO 或 /* ... */ 会直接抛出 Unexpected token / in JSON at position X 错误，右下角弹窗提示“Invalid configuration file”，所有后续配置项将被忽略。
- 即使只是加了一行
// enable debug mode，整个settings.json就算“废掉”了 - VSCode 不会跳过错误行，也不会静默降级——它会停在第一个非法字符处
- 插件如 Better Comments 对
settings.json文件完全不生效，因为该文件语言模式是jsonc（带注释的 JSON），但 VSCode 自身配置加载器只认纯 JSON
真正安全的注释方式：用 jsonc 模式 + 正确后缀
VSCode 允许你把配置文件改名为 settings.jsonc（注意末尾 c），此时编辑器会启用 jsonc 语言模式，支持 C 风格注释（// 和 /* */），且 VSCode 加载器能正确解析它——前提是文件名必须是 .jsonc，不能只是在 settings.json 里手动加注释。
- 关闭当前
settings.json文件 - 在资源管理器中右键 → “重命名”，改为
settings.jsonc - 重新打开该文件，确认右下角语言模式显示为
JSON with Comments - 现在可以放心写：
// Enable Prettier on save或/* legacy config, to be removed in v1.5 */ - 保存后立即生效，无需重启 VSCode
团队协作时要注意的兼容性陷阱
不是所有 VSCode 版本或环境都默认接受 settings.jsonc 作为用户配置入口。VSCode 从 1.60 版本起才稳定支持将 settings.jsonc 用于用户设置，但部分旧版远程开发容器、CI 环境或企业策略锁死配置路径时，仍可能只读取 settings.json。
- 如果你把
settings.jsonc提交到团队仓库，需同步更新 README，说明“请使用 VSCode ≥ 1.60” - 不要在
.vscode/settings.json（工作区配置）中用.jsonc后缀——VSCode 工作区加载器目前仍强制要求纯.json - 若必须兼顾老旧环境，可用“伪注释”字段：
"_COMMENT_enable_debug": "true — only for local dev"，靠 key 名以_开头 + 显式说明来模拟注释语义
最易被忽略的一点：VSCode 设置 UI（图形界面）每次修改都会覆盖 settings.jsonc 并**强制导出为纯 settings.json**。一旦你通过 GUI 点了几下设置，手写的注释就全没了。所以，坚持用 jsonc 的前提，是全程禁用设置 UI 编辑，只用代码编辑器维护该文件。
