Properties 转 YAML

Spring Boot 的 application.properties 和 application.yml 互相转换,支持多层嵌套和列表下标;中文与 \uXXXX 转义互转,解决 .properties 中文乱码;按 Java 规范解析续行、注释和转义字符,表格列出所有键值,并检查重复键、行尾空格和键冲突。

键值列表

.properties 的写法规则

  • 分隔符:键和值之间可以用 =、: 或空格分隔,分隔符前后的空格会被忽略,但值末尾的空格会被保留,这是很多“明明写对了却读不到”问题的原因。
  • 注释和续行:以 # 或 ! 开头的行是注释;一行末尾写反斜杠 \ 表示下一行接着写,下一行开头的空格会被忽略。
  • 中文乱码:Java 8 及更早版本按 ISO-8859-1 读取 .properties,中文必须写成 中文 这样的转义;Java 9 起 ResourceBundle 默认按 UTF-8 读取。部分框架和旧工具仍按 ISO-8859-1 读取,遇到乱码时可以勾选“输出时把中文转成 \uXXXX”。
  • 转成 YAML 的对应关系:spring.datasource.url 变成三层缩进;list[0] 变成 YAML 列表项;同一个键既有值又有下级(如 a=1 和 a.b=2)时 YAML 无法表示,工具会给出提醒。
  • YAML 的坑:YAML 中 on、yes、no、以 0 开头的数字可能被解析成布尔值或八进制,转换时这类值会加上引号。

其他格式的配置文件可以用 INI 配置文件编辑器、JSON 与 YAML 互转。

Properties 转 YAML常见问题

Properties 转 YAML怎么使用?

选择转换方向:Properties 转 YAML、YAML 转 Properties、中文与 Unicode 互转或 Properties 转 JSON;在左侧粘贴内容,右侧实时生成结果,下方列出重复键、行尾空格等问题和所有键值,点“把结果作为输入”可以反向转换。

application.properties 怎么转 application.yml?

粘贴到左侧选择 Properties → YAML,复制结果保存为 application.yml 即可。

properties 中文乱码怎么办?

把中文转换成 \uXXXX 转义写法,或者确认读取时使用 UTF-8 编码。

列表在 properties 中怎么写?

用下标表示,例如 app.servers[0]=a、app.servers[1]=b,转成 YAML 后是列表。

properties 和 yml 同时存在以哪个为准?

Spring Boot 中同一位置的 .properties 优先级高于 .yml,建议只保留一种。

Properties 转 YAML的结果应怎样理解?

YAML 转 Properties 时会把所有值转为字符串;Spring Boot 的多文档 YAML(--- 分隔)会依次转换;属性中引用的 ${} 占位符保持原样。

输入内容会保存或发给外部服务吗?

配置内容只在浏览器本地转换,不会上传。

没有结果或操作失败时先检查什么?

转换后 Spring Boot 读不到配置,检查键名是否有行尾空格或拼写错误;中文乱码时把中文转成 \uXXXX。

相关工具

Dockerfile 生成器 · 乱码修复与字符集转换 · Crontab 表达式生成器 · JSON 格式化校验 · 全部开发工具