使用指南

JSON、YAML、TOML 与 Properties：配置格式如何选择

理解四种常见结构化配置格式的可读性、嵌套方式和转换边界。

JTools 维护者 · 更新于 2026-10-11

JSON 语法严格、生态广泛，适合 API 和工具交换数据；它要求字符串键与双引号，对注释不友好。YAML 更接近自然书写，缩进代表层级，适合人工维护的配置，但应避免混用制表符和空格。

TOML 以键值和表为中心，层级清晰且适合项目配置。它的顶层必须是表，日期时间、数组表等语义较 JSON 更丰富；跨格式转换时，工具会将日期时间作为文本保留，避免擅自改变时区含义。

Java Properties 是扁平键值文本。嵌套对象通常用 server.port 这类点路径表示，数组没有统一标准。本工具输出 Properties 时会展平对象，并把数组编码成 JSON 文本，读取 Properties 时不会猜测并还原层级。

转换前应保留原文件副本。格式可以转换，运行时语义却可能不能一一对应，例如注释、锚点、自定义标签和特定框架对 Properties 数组的约定。