YAML Formatter

YAML 格式化器将格式混乱的 YAML 代码重新整理为缩进一致、结构清晰的格式。工具使用 YAML 解析器读取原始内容，解析文档结构，然后按照 YAML 规范重新生成格式化的输出。支持自定义缩进大小（通常为 2 空格）、引号风格选择、多行字符串样式等配置选项。

YAML 格式化在 DevOps 和配置管理中非常重要。格式化 Docker Compose 文件以确保服务定义清晰可读；整理 Kubernetes 资源配置文件方便查找和管理；统一 Ansible playbook 的格式风格；规范化 CI/CD 流水线配置文件（如 GitHub Actions、GitLab CI）；格式化 OpenAPI/Swagger 规范文档。

格式化后的 YAML 可以使用 JSON 格式化器 对比 JSON 和 YAML 的结构差异。YAML 和 JSON 之间的转换可以使用对应的格式转换工具。

YAML 使用缩进表示嵌套结构，格式化器确保所有同级元素使用相同的缩进级别。格式化规则包括：统一使用空格（不混合 Tab 和空格）、列表项使用 "- " 前缀并保持与父级相同的缩进、键值对使用 ":" 后跟空格分隔、多行字符串保持合适的缩进、注释保持与上下文适当的对齐。

YAML 支持块式（Block Style）和流式（Flow Style）两种写法。块式使用缩进和换行，可读性好；流式使用 和 []，类似于 JSON。格式化器通常保持原有的样式选择，或提供转换为块式的选项以提高可读性。

• Tab 缩进问题：YAML 规范禁止使用 Tab 字符作为缩进。包含 Tab 缩进的 YAML 会导致解析错误，格式化器会将其转换为空格。
• 类型推断：YAML 的自动类型推断可能导致格式化（解析再序列化）后的语义与原文件不同，如 "yes" 变为 true。
• 锚点别名处理：YAML 的 &anchor 和 *alias 特性在格式化后可能被展开或重新排列，改变原有引用关系。
• 多文档文件：使用 --- 分隔多个 YAML 文档的文件格式化时，需注意分隔符前后文档的独立性。
• 注释位置：格式化可能移动注释的位置，特别影响行内注释（inline comment），可能导致注释与对应的配置项不再关联。

在需要快速格式化 YAML 配置文件、统一团队 YAML 风格、或在编辑器中粘贴格式化时使用此工具。对于项目中的持续 YAML 格式化需求，推荐使用 Prettier（支持 YAML 插件）或专门的 YAML 校验工具（如 yamllint），它们支持可配置的规则、与 IDE 和 CI/CD 集成。