JSON写了注释就报错，配置说明应该放在哪里

标准JSON没有注释语法，也不接受用单引号代替字符串的双引号。编辑器高亮正常不代表对接解析器会接受。需要说明配置含义时，应明确使用文档、约定字段或另一种双方支持的格式。

语法校验实拍：为演示错误位置，手动输入含尾随逗号的非敏感样例，并在KKCE官网执行校验。这是教学样例，不是实际生产接口故障。

先弄清文件实际采用的格式

扩展名相似的配置可能使用JSONC、JSON5或工具自带的宽松解析。它们能接受的写法不应自动搬进标准JSON接口。检查项目的读取库和构建过程，确认注释是否在进入正式解析前被预处理。

用最小样本找到冲突字符

保留一个简单字段，分别测试加上双斜杠说明、单引号和多余逗号后的结果。可在KKCE JSON工具观察合法性。一次只改一处，得到的错误位置才有参考意义；不要大段删除内容直到“终于能过”。

说明文字可以独立管理

面向维护者的解释适合放在版本管理中的配置文档，和字段版本一起更新。若协议专门约定描述字段，也应标明哪些字段会被程序读取，不能任意添加_note后假定所有接收方都忽略它。

格式迁移需要接收端同意

改用YAML等形式之前，确认部署程序确实支持，并测试布尔值、数字和引号规则。为了多写几行说明而悄悄更换文件语义，可能把简单语法问题变成运行配置错误。严格且清楚的契约更便于跨语言协作。