什么是 PROPERTIES 文件?
`.properties` 文件是 Java 与 Spring 生态系中最经典的键值(Key-Value)配置文件格式,广泛应用于应用程序参数配置、数据库连接池设置与 i18n 国际化文本字典。
随着现代云原生架构与微服务技术演进,YAML 与 JSON 成为更主流的配置格式。本工具支持 Properties ⇄ JSON ⇄ YAML 多向自由互转,支持点号嵌套展平、Unicode 中文字符转义与多行转义解析,极大简化了 Spring Boot 配置文件的重构与迁移工作。
核心功能特点
多向无缝转换
支持 Properties ➔ JSON、JSON ➔ Properties、Properties ➔ YAML 等 4 种常用模式。
Unicode 自动编解码
自动识别 \uXXXX 中文编码,可自选是否生成标准 ASCII 转义字符。
嵌套树状结构支持
支持将 server.port 点号结构智能展开为嵌套 JSON/YAML 对象。
纯前端隐私安全
所有配置文件均于浏览器内存本地解析,零服务器上传,保护数据库密码。
常见问题 (FAQ)
1. 这个转换器会将数据上传到服务器吗?
绝对不会。我们非常重视您的数据隐私。所有的解析和转换过程均在您的浏览器本地内存中完成,您的配置信息(如数据库密码、API 密钥等)绝不会外泄。
2. 转换器支持 Unicode 转义 (\uXXXX) 吗?
支持。在由 Properties 转 JSON 时,工具会自动将 `\uXXXX` 解码为真实汉字;在由 JSON/YAML 转回 Properties 时,可勾选“Unicode 转义”按钮自动将非 ASCII 字符编码以适应老旧 Java 系统。
3. Properties 中的注释 (# 或 !) 会被保留吗?
由于标准 JSON 格式不支持注释行,在转换为 JSON 时以 `#` 或 `!` 开头的注释行会被略过。
4. 支持嵌套结构的 JSON 转 Properties 吗?
支持。嵌套对象会被自动展平(Flattening),使用点号 `.` 作为层级连接符(例如 `{"db": {"host": "localhost"}}` 会自动转换为 `db.host=localhost`)。
5. 如何将扁平的点号键展开为嵌套 JSON 对象?
在 Properties ➔ JSON 模式下,勾选顶部的“展开点号为嵌套对象 (Tree)”选项,工具便会将 `server.port=8080` 解析为 `{ "server": { "port": "8080" } }` 树状对象。
6. 支持以反斜杠结尾的多行 Properties 值吗?
完全支持。依照 Java 规范,行尾单个反斜杠 `\` 会被识别为换行续行符号,解析器会将多行合并为单一完整字符串。
7. 支持 INI 配置文件格式吗?
支持基础键值解析。标准 INI 的 `key=value` 键值对可直接贴入转换,`[section]` 段落名称会被略过或作为普通键值识别。
8. 能一键下载转换后的配置文件吗?
可以。点击右侧上方的“下载”按钮,即可根据当前转换模式自动生成并下载 `.properties`、`.json` 或 `.yaml` 本地文件。