什么是 YAML / JSON / Properties 互转？

YAML、JSON 和 Properties 是三种常见的配置文件和数据交换格式。YAML 以简洁的缩进语法著称，广泛用于 Kubernetes、Docker、Spring Boot 等项目配置。JSON 是最通用的数据交换格式，几乎所有编程语言都原生支持。Properties 是 Java 生态中传统的配置格式，使用 key=value 的扁平结构。

在实际开发中，经常需要在这三种格式之间互相转换。例如将 Spring Boot 的 application.properties 迁移到 application.yml，或将 JSON 配置转为 YAML 格式以适配新项目。

为什么需要 YAML / JSON / Properties 互转工具？

格式转换在项目迁移和协作中非常常见：

项目迁移：从 Java Properties 配置迁移到 YAML 或 JSON 格式
格式统一：将混合使用的配置文件统一为同一种格式
数据转换：在不同系统之间交换配置时，需要转换数据格式
文档编写：将 JSON 数据转为 YAML 写入文档，提高可读性
调试排查：将 YAML 配置转为 JSON，使用 JSON 工具验证和查看

使用 IqsBot YAML / JSON / Properties 互转工具，你可以快速在三种格式之间互相转换，无需安装任何软件。

相比其他在线格式转换工具，IqsBot 的核心优势是纯浏览器端运行——你的配置数据不会上传到任何服务器，完全在本地处理。对于包含数据库密码、API 密钥等敏感信息的配置文件，这一点尤其重要。

如何使用 IqsBot YAML / JSON / Properties 互转工具

基础用法

选择转换方向（如 JSON → YAML）
将源格式数据粘贴到左侧输入框
点击「转换」按钮
右侧显示转换后的目标格式数据
点击「复制结果」保存

高级功能

六种转换方向：支持 JSON → YAML、YAML → JSON、JSON → Properties、Properties → JSON、YAML → Properties、Properties → YAML 全部六种互转
示例数据：每个转换方向都有示例数据，快速了解格式
交换输入输出：点击「交换」将输出变为输入，方便反向转换
错误提示：格式不正确时显示具体错误信息，帮助快速定位问题
一键清空：快速清空输入输出内容

使用示例

示例1：JSON 转 YAML

输入 JSON：

{
  "app": {
    "name": "IqsBot",
    "port": 3000
  },
  "debug": true
}

转换后 YAML：

app:
  name: IqsBot
  port: 3000
debug: true

示例2：Properties 转 JSON

输入 Properties：

app.name=IqsBot
app.port=3000
debug=true

转换后 JSON：

{
  "app": {
    "name": "IqsBot",
    "port": 3000
  },
  "debug": true
}

示例3：YAML 转 Properties

输入 YAML：

database:
  host: localhost
  port: 5432
  name: mydb

转换后 Properties：

database.host=localhost
database.port=5432
database.name=mydb

常见问题

Q: Properties 格式中嵌套键是怎么表示的？

A: Properties 是扁平的键值对格式，不支持嵌套结构。嵌套键使用点号分隔，例如 app.server.port=8080 对应 JSON 中的 {"app": {"server": {"port": 8080}}}。转换时会自动处理嵌套层级。

Q: 支持带注释的 YAML 转换吗？

A: 当前版本的 YAML 解析基于标准 YAML 规范，注释在转换过程中会被忽略。转换后的输出也不包含注释。如果需要保留注释，建议手动编辑转换后的文件。

Q: 我的配置数据会上传到服务器吗？

A: 绝对不会。IqsBot 的所有工具都运行在浏览器本地，配置数据不会离开你的设备。即使断网，格式转换工具依然可以正常使用。对于包含密码、密钥等敏感信息的配置文件，可以放心使用。

Q: 支持哪些数据类型？

A: 支持常见的数据类型，包括字符串、数字、布尔值、null、对象（映射）和数组。YAML 中的特殊类型（如日期、多行字符串）会被转换为 JSON 中的字符串表示。

Q: JSON 转 YAML 后缩进是什么？

A: YAML 输出使用 2 空格缩进，这是 YAML 推荐的缩进风格。行宽不限制（lineWidth: -1），不会自动折行长字符串。

Q: 转换后格式有变化怎么办？

A: 格式转换是双向的，如果对转换结果不满意，可以点击「交换」按钮将输出变为输入，尝试反向转换。也可以微调输入格式后重新转换。工具会尽量保持数据完整性，转换前后的数据语义应保持一致。