点号扁平化是怎么回事
Properties 是扁平的键值对格式,没有嵌套概念。所以 {"server":{"port":8080}} 会被写成 server.port=8080。反过来,带点号的键在还原 JSON 时会重新变成嵌套对象——这也是 Spring Boot 的配置绑定规则。
哪些值会被转成字符串
Properties 里所有值本质都是字符串,所以布尔和数字写进去后就是 true 和 8080 的字面文本。反向转换时,纯数字和 true/false 会被自动还原成数字与布尔值;想强制保留字符串,请在 JSON 里写成带引号的形式(本工具统一按字面还原,不做类型推断的键可用前缀保护)。
转义规则
键里的 =、:、空格,以及值里的换行、反斜杠都需要转义。含中文时注意 Properties 文件默认按 ISO-8859-1 读取,Java 8 之后可用 UTF-8,建议同时确认你项目的编码设置。
功能说明
JSON 与 Properties 互转
Properties(以及 .env)是「扁平键值对 + 点号路径」的配置格式,Java 的 application.properties、Node 的 .env、各种系统的环境变量都是这套思路。JSON 则是嵌套结构。两者之间的转换看似简单,但坑不少:类型丢失、点号歧义、转义规则不一致。
本工具的处理方式
- 扁平化:
{"db":{"host":"localhost","port":3306}}→db.host=localhost与db.port=3306。 - 数组:写成
key[0]=a、key[1]=b,还原时按索引重组(Spring 也支持key.0写法,本工具输出方括号形式更明确)。 - 分组注释:同一层级的键会带一行
# 分组名注释,方便人读。 - 排序:默认按键名排序,让 diff 更干净;关掉则保留原始顺序。
- 还原类型:Properties 转 JSON 时,纯整数、小数、true/false 会被还原成对应类型,其余保持字符串。
什么时候该用哪个
- Properties / .env:部署配置、密钥、开关,人需要直接改,一行一个值最直观。
- JSON:结构化的数据、多层嵌套、需要类型(数组、布尔、数字)的地方。
- 两者都要:常见做法是源配置用 JSON,部署时生成为 .env 注入容器。
使用步骤
1. 在「输入框」中粘贴要处理的内容。
2. 点击「JSON → Properties」按钮执行。
3. 确认结果无误后,用「复制」保存到本地。
常见问题
JSON与Properties互转能做什么?
JSON 与 Properties / .env 双向互转:嵌套对象自动用点号扁平化成 a.b.c,支持注释与转义。全部处理在浏览器本地完成,无需注册、无需安装。
支持哪些格式互转?
支持 JSON、XML、YAML、CSV 等结构化文本格式。源格式不合规范时转换会失败或丢字段,建议先校验再转。
转换过程会丢信息吗?
存在能力差异时就会丢:比如带样式的内容转纯文本会失去排版,嵌套结构转平面表格会拍平层级。转换前想清楚下游要用哪些字段,只保留需要的部分更稳。
大文件转换会不会卡住?
解析和重新序列化都在内存里完成,文件越大越吃内存。几 MB 的文本通常瞬间完成,几十 MB 时浏览器可能卡顿甚至崩溃,建议先拆分。
你可能还想问
这个工具需要联网才能用吗?
第一次打开页面需要联网加载,之后的计算与处理都在本地完成,断网也能继续操作。数据不经过服务器,也不受网络波动影响。
处理结果怎么保存或分享?
结果区支持一键复制,也可按页面提供的下载入口保存到本地;页面不做云端存储,关掉浏览器后需要重新处理。
速查在线工具箱