YAML 在线转换工具使用教程
什么是 YAML？
YAML（YAML Ain\'t Markup Language，即"又不是一个标记语言"）是一种人类友好的数据序列化格式，由 Clark Evans 等人于 2001 年创建。YAML 使用简洁的缩进语法来表达数据结构，无需使用大括号、引号或分号，可读性极强，被誉为"最适合编写配置文件的格式"。
YAML 被广泛应用于各种开发场景：Docker Compose 服务编排、Kubernetes 资源定义、GitHub Actions CI/CD 工作流、Ansible 自动化运维、Spring Boot 应用配置等。几乎所有现代开发工具和平台都原生支持 YAML 格式。
ToolYou 提供了专业的 YAML ↔ Properties 转换工具，支持双向实时转换、嵌套结构智能处理、特殊字符正确转义，是配置文件迁移和格式转换的得力助手。
ToolYou YAML 工具核心功能
🔄 双向格式转换
工具支持 YAML 与 Java Properties 格式之间的双向互转：
YAML → Properties：将 YAML 格式的配置文件转换为 Properties 格式，适用于 Java 项目配置迁移
Properties → YAML：将 Properties 格式的配置文件转换为 YAML 格式，适用于现代配置文件管理
用户可通过顶部的模式切换按钮轻松选择转换方向。
🌳 嵌套结构自动处理
工具能够智能处理 YAML 的嵌套结构。YAML 中的嵌套对象会自动转换为 Properties 的点号分隔格式（如 server.port: 8080），反向转换时工具会自动识别点号分隔的键名并将其还原为 YAML 的嵌套结构。YAML 的列表（数组）也会正确转换为带索引的 Properties 格式（如 servers.0=localhost）。
🔀 一键交换输入输出
工具提供了交换按钮，可以一键将输出内容切换为输入内容，方便用户快速对比和验证转换结果的正确性。
📋 实时复制功能
输入区和结果区均支持一键复制功能。点击复制按钮即可将对应内容复制到剪贴板，方便粘贴到其他项目或编辑器中使用。
📝 清空与清除
工具提供清空按钮，可以快速清除输入区内容，方便开始新的转换任务。结果区在输入内容变化时会自动更新。
📊 实时统计信息
工具实时显示输入内容的行数统计和字符数统计，帮助用户了解数据规模。统计信息位于输入区下方，清晰直观。
📋 内置示例数据
工具内置了丰富的示例数据，涵盖常见的 YAML 和 Properties 配置场景。点击「示例」按钮即可快速加载示例，帮助用户了解两种格式的语法差异和结构特点。
📚 转换历史记录
工具自动保存历史转换记录，用户可以快速回顾之前的转换内容。历史记录显示转换时间、输入输出预览等信息，支持点击历史记录快速恢复之前的内容。
✅ 智能错误提示
当输入内容格式不正确时，工具会显示详细的错误提示信息，帮助用户快速定位和修正语法问题。错误提示包含具体的错误原因，便于用户理解。
🔒 本地处理安全保障
所有转换操作均在浏览器本地完成，配置数据不会上传到任何服务器，确保配置文件的安全性和隐私性。这对于处理包含敏感信息的配置文件（如数据库连接信息、API 密钥等）非常重要。
YAML 基础语法要点
基本结构
YAML 使用缩进来表示层级关系，不区分行和列，主要语法元素包括：
键值对：使用冒号
:分隔，如name: John列表：使用短横线
-开头，如- item1嵌套对象：通过缩进表示层级，如子键相对于父键缩进 2 个空格
数据类型
YAML 支持多种数据类型：
字符串：直接书写，如
message: Hello数字：整数或浮点数，如
age: 25布尔值：
true/falsenull：
null或~列表：使用
-开头对象：使用
key: value格式
引号使用
YAML 中可以使用单引号 ' 或双引号 " 包裹字符串：
单引号：不解析转义字符，如
'hello\\nworld'会原样输出双引号：解析转义字符，如
"hello\\nworld"会换行显示
对于包含特殊字符（如冒号、逗号、井号等）的字符串，建议使用引号包裹。
Properties 基础语法要点
基本结构
Properties 是 Java 特有的键值对配置格式，语法简洁：
每行一个键值对，格式为
key=value使用点号
.分隔层级，如server.port=8080使用
#或!开头表示注释
常见场景
Properties 格式主要用于：
Spring Boot 配置：
application.properties文件Java 资源文件：
.properties资源文件简单配置：键值对简单直接的配置场景
如何使用 YAML 转换工具？
场景一：YAML 转 Properties
访问页面：打开 /yaml 工具页面
选择模式：点击「YAML → Properties」按钮
输入 YAML：在左侧输入框粘贴 YAML 配置内容
查看结果：右侧自动显示转换后的 Properties 格式
场景二：Properties 转 YAML
选择模式：点击「Properties → YAML」按钮
输入 Properties：在左侧输入框粘贴 Properties 配置内容
查看结果：右侧自动显示转换后的 YAML 格式
场景三：加载示例快速学习
点击示例：点击工具栏的「示例」按钮
观察结构：查看示例数据的 YAML 和 Properties 格式对比
理解差异：通过示例理解两种格式的结构差异
场景四：交换内容对比
完成转换：完成一次格式转换后
点击交换：点击交换按钮，将结果内容切换为输入
验证结果：重新转换验证结果的正确性
场景五：复制使用
复制输入：点击输入区复制按钮，复制原始内容
复制结果：点击结果区复制按钮，复制转换后的内容
使用内容：将复制的内容粘贴到项目中
YAML 常见应用场景
Docker Compose：定义多容器应用的服务、网络和卷配置
Kubernetes：定义 Pod、Service、Deployment 等资源对象
GitHub Actions：编写 CI/CD 工作流和自动化任务
Spring Boot：
application.yml应用配置文件Ansible：编写自动化运维剧本和角色配置
Node.js：Vue CLI、Nuxt 等框架的配置文件
YAML 与 Properties 格式对比
特性YAMLProperties可读性高（缩进结构清晰）中等（点号分隔略显冗长）嵌套支持原生支持通过点号模拟数据类型丰富（字符串、数字、布尔、列表等）仅字符串注释语法# 开头# 或 ! 开头适用场景复杂配置、K8s、Docker简单配置、Spring Boot
常见问题解答
Q: YAML 和 Properties 有什么区别？
A: YAML 是一种通用的数据序列化格式，支持嵌套结构、列表和多种数据类型，广泛应用于各种编程语言的配置文件。Properties 是 Java 特有的键值对配置格式，结构扁平，所有值都是字符串类型，通过点号分隔符模拟层级关系。YAML 更适合表达复杂的数据结构，而 Properties 则更加简单直接。
Q: 转换是否支持嵌套结构？
A: 完全支持。YAML 的嵌套对象会自动转换为 Properties 的点号分隔格式（如 server.port: 8080），反向转换时工具会自动识别点号分隔的键名并将其还原为 YAML 的嵌套结构。同时，YAML 的列表（数组）也会正确转换为带索引的 Properties 格式（如 servers.0=localhost）。
Q: 如何处理特殊字符和中文？
A: YAML 中，包含特殊字符的值可以用单引号或双引号包裹来保持字面意义。中文等 Unicode 字符在 YAML 中可以直接使用。在 Properties 格式中，特殊字符可能需要使用反斜杠转义（如 \\n、\\t），中文通常可以直接存储，但在某些旧版 Java 环境中可能需要使用 \\u 形式的 Unicode 转义。
Q: 哪些项目常用 YAML 配置文件？
A: YAML 被广泛用于多种项目类型：Docker Compose（服务编排配置）、Kubernetes（资源定义）、GitHub Actions（CI/CD 工作流）、Ansible（自动化运维）、Spring Boot（application.yml）、Node.js 框架（如 Nuxt、Vue CLI 的配置文件）等。几乎所有现代开发工具和平台都支持 YAML 格式的配置。
Q: 配置文件数据会被上传到服务器吗？
A: 不会。所有转换操作均在浏览器本地完成，您的配置数据不会上传到任何服务器，确保配置文件的安全性和隐私性。这对于处理包含敏感信息（如数据库连接信息、API 密钥等）的配置文件非常重要。
Q: 转换失败怎么办？
A: 请检查输入内容的格式是否正确。YAML 对缩进非常敏感，请确保使用空格（推荐 2 个空格）而非 Tab 键进行缩进。Properties 文件中，键名通常使用小写字母、数字和点号，避免使用特殊符号。如果转换结果不符合预期，请检查输入格式是否符合 YAML 或 Properties 语法规范。
💡 提示：ToolYou 还提供 JSON 格式化工具、JSON ↔ XML 互转、Base64 编解码等相关工具，欢迎访问！