SublimePrettyJSON插件更新后JSON文件保存问题的技术解析

问题背景

近期Sublime Text用户反馈在更新至4180版本后，保存JSON配置文件时出现异常。主要表现为：

1. 无法保存包含注释的JSON文件
2. 无法保存带有尾部逗号的JSON格式
3. 文件末尾换行符被意外移除

经技术分析，这些问题实际上源于SublimePrettyJSON插件的更新，而非Sublime Text 4180版本本身。

技术原理分析

JSON与JSONC格式差异

标准JSON规范严格规定：

• 不允许注释
• 禁止在最后一个元素后添加逗号
• 必须是严格的键值对结构

而Sublime Text的配置文件实际采用JSONC(JSON with Comments)格式，这是JSON的超集，允许：

• 单行(//)和多行(/* */)注释
• 尾部逗号
• 更宽松的语法结构

插件行为变更

SublimePrettyJSON最新版本修复了事件监听机制，现在会正确处理on_post_save事件。这一改进虽然修复了其他问题，但导致：

1. 插件会严格校验JSON格式
2. 自动格式化时会移除不符合标准JSON规范的内容

解决方案

方案一：禁用自动格式化

在插件设置中关闭保存时自动格式化功能：

{
    "pretty_on_save": false
}

方案二：配置例外文件

修改插件设置，将Sublime配置文件排除在JSON校验之外：

{
    "as_json": [
        "*.json",
        "*.sublime-settings",
        "*.sublime-keymap",
        "*.sublime-color-scheme"
    ]
}

方案三：临时处理措施

手动调整文件内容：

1. 移除所有JSON注释
2. 删除尾部逗号
3. 确保文件格式符合标准JSON规范

最佳实践建议

1. 对于Sublime Text配置文件，建议采用方案二设置例外
2. 对于需要严格JSON格式的项目文件，保持插件默认设置
3. 开发团队内部应统一JSON文件格式规范
4. 重要配置文件修改前建议备份

技术延伸

理解此问题有助于开发者：

1. 区分JSON和JSONC的应用场景
2. 掌握IDE/编辑器插件的交互机制
3. 认识配置文件格式规范的重要性
4. 提高问题排查能力，区分核心软件与插件的问题边界