YAML、JSON、Properties有什么区别？配置文件该怎么选

三种格式分别是什么

JSON是一种严格的数据交换格式，结构清晰，适合接口、前端状态和机器处理。YAML更强调可读性，支持缩进层级，常用于配置文件、CI流程、Docker和Kubernetes。Properties是简单的键值配置格式，在Java和Spring项目中很常见。

三者都能表达配置，但表达能力和使用习惯不同。JSON适合程序传输，YAML适合人阅读和维护复杂层级，Properties适合扁平配置和简单场景。选择哪种格式，不是看谁更高级，而是看团队、框架和工具链支持。

JSON语法严格，必须使用双引号，不能有注释，末尾不能多逗号。好处是解析稳定，不容易产生歧义。YAML可读性好，但缩进非常敏感，空格层级写错就可能改变含义。Properties最简单，一行一个键值，但表达数组和嵌套对象不如前两者自然。

新手使用YAML时最容易踩缩进坑，尤其是复制配置片段时混入Tab或层级错位。JSON常见问题是注释和尾逗号。Properties常见问题是键名重复、中文编码和层级命名不统一。

从JSON转YAML时，通常能比较自然地保留对象和数组结构。从YAML转JSON时，要注意YAML中的特殊值、布尔值、日期和多行字符串可能被解析成不同类型。从JSON转Properties时，通常需要把嵌套结构扁平化，例如server.port=8080。

转换工具能节省时间，但不能代替人工检查。配置文件往往影响启动和部署，转换后应重点检查关键字段、层级、数组、布尔值和环境变量占位符。

接口数据和前后端通信优先JSON；部署配置和DevOps场景常用YAML；Java传统配置和简单键值场景常用Properties。团队已有规范时，优先遵守项目规范，不要为了个人喜好频繁混用。

工具帮的JSON/YAML/Properties转换工具适合做样例转换、配置迁移预览和格式校验。真实生产配置建议配合版本管理，修改后走测试环境验证，避免因为格式小错误导致服务无法启动。

配置文件最重要的是稳定和可维护。无论选择哪种格式，都应避免同一项目里到处混用不同风格。命名规则、缩进规则、环境变量写法、注释习惯应尽量统一，否则时间一长配置会变得难以排查。

上线前建议把配置文件纳入版本管理，并为关键环境保留变更记录。很多线上事故不是代码错误，而是配置层级写错、环境变量未生效、测试配置误用到生产环境。格式转换后尤其要做启动验证。

不一定。YAML更适合人工配置，JSON更适合数据交换和机器处理。

可以通过点号命名模拟层级，但本质仍是扁平键值。

不建议直接上线，应检查关键字段并在测试环境验证。