Spring Boot 的 application.yml 与 application.properties 打架多年:左边是层级清晰的树,右边是几十行拍平的键。这里双向搬:嵌套键拍平成 server.port=8080,数组两种风格,数字布尔自动推断类型,注释跟着键走,往返自检一键验证。
你粘贴的配置只在本页内存里处理,不上传到服务器,也不用登录;数组风格、缩进这些界面选项会存在这台设备的浏览器里,换设备、换浏览器或清缓存会丢。想删掉本机选项,点页脚的「清空我的数据」。生产环境的密钥类配置别贴进任何在线工具。
逗号 输出 items=a,b,c(省行数);索引 输出 items.0=a 逐行(Spring 两种都认,索引式还能给每个元素挂注释)。YAML 侧:映射、序列、缩进嵌套、flow 写法([a, b]、code>{k: v} 不对,是 {k: v})、单双引号字符串、数字、布尔、null(~ 或留空)、注释、块标量 | >。块标量多行文本转 Properties 时压成 \n 转义的单行,转回时还原。
Properties 侧:键扁平化(a.b.c=v 重建为三层嵌套)、= 与 : 两种分隔符、续行反斜杠、\u4e2d Unicode 转义、# 与 ! 注释。值里类型自动推断:纯数字转数字、true/false 转布尔、空值转 null。
锚点 &、多文档 ---、标签 !! 不支持——遇到直接报错标行号,不会静默丢内容。这与站内 JSON⇄YAML 工具的解析器是同一套行为,同一个文件两个工具解析结果一致。
最典型的是 Spring Boot 配置搬家:老项目全是 properties,新同事写的是 yml,两边来回核对靠肉眼对键名很煎熬。转一遍,键集合一致当场可见。
再就是写文档或排查环境差异时,把配置转成 properties 的扁平键做 diff,比在 YAML 层级里对齐缩进直观得多。
| 输入格式 | YAML(映射/序列/缩进/flow/引号/注释/块标量)或 Java Properties(= 与 : 分隔、续行、Unicode 转义) |
|---|---|
| 输出格式 | 对方格式;YAML→Properties 嵌套键拍平(a.b.c=v),数组逗号式或索引式可选;Properties→YAML 层级重建 + 类型推断 |
| 关键参数 | 数组风格默认逗号;缩进默认 2;?arr=index&indent=4 直达;注释跟随最近键保留 |
| 处理方式 | 浏览器本地解析转换,不上传、不收集、断网可用;界面选项存本机 localStorage |
| 上限 | 单次输入 1MB(约几万行配置,毫秒级) |
| 已知边界 | 不支持锚点与引用(& *)、多文档(---)、标签(!!);块标量多行文本会转义成单行再还原;日期按字符串原样保留 |
两种风格可选:逗号分隔(items=a,b,c)或索引式(items.0=a、items.1=b、items.2=c)。Spring Boot 官方两种都认,索引式可以保留每个元素的注释位置,逗号式更省行数,转换前在选项里切换。
不丢。YAML 里的 # 注释会跟随它下面最近的那个键一起搬到 Properties;反过来 Properties 的 # 注释也会挂在对应键上带回 YAML。唯一例外是文件最顶部、还没遇到任何键的注释,会统一放在输出开头。
不会,类型会自动推断:8080 输出成数字、true/false 输出成布尔、空值输出成 null,带引号的才保持字符串。想强制某值是字符串,在 Properties 里用引号包住它即可。
不会。解析和转换全部在这台设备的浏览器里完成,页面没有上传接口,断网也能用。只有数组风格、缩进这些界面选项记在本机 localStorage,换设备不跟走,页脚「清空我的数据」一键删掉。内网配置也别贴进来路不明的在线工具。
键值集合完全一致:每个键、每个值(含数字、布尔、null、数组)往返后一一对应,页面里有「往返自检」按钮可以当场验证。顺序和排版可能不同(Properties 天然按键排序更稳),块标量多行文本会转成转义后的单行再还原。
同一个 YAML 解析器内核(自写,报错带行号),行为一致:同一个 YAML 文件在这里和在 json-format 里解析出的结构等价。区别只在这边对接的是 Properties 而不是 JSON。