YAML 转 JSON

相关推荐

关于 YAML 转 JSON：把 YAML 配置自动转换为标准 JSON 对象

适用场景

• Spring Boot 应用配置：把 application.yml 及 application-{profile}.yml 转为 JSON，方便 Java 后端用 ObjectMapper 反序列化加载或注入 Apollo/Nacos 配置中心。
• Mock 服务定义：把 WireMock mappings、Postman Collection v2.1 的 YAML 转为 JSON，配合 Jest/Mocha 单测做接口响应断言和回归测试。
• 跨工具工作流：先在 yaml-to-json 把 docker-compose.yml 的 services 块转 JSON 数组，再粘贴到 to-csv 工具导出服务清单给运维做资产盘点。
• 同模块工作流：把嵌套很深的 YAML 转 JSON 后，再粘贴到 format 工具做缩进统一、键名排序、字段合并等二次美化。
• 第三方 YAML 修复：厂商提供的接口契约 YAML 混用制表符缩进且键名带连字符（如 auth-type）导致解析失败，粘贴进来点「修复结构」一键修复后转 JSON 提交联调工单。
• ES 索引模板：把 Elasticsearch index template、ingest pipeline YAML 转为 JSON 后导入 Kibana 做索引生命周期管理（ILM），或反向将索引 mapping 转 YAML 提交 DBA 评审。
• 技术博文素材：技术博主写「YAML vs JSON 选型指南」时，把同一份 K8s Deployment 两种格式并排展示，用本工具做实时转换对比作为配图素材。
• 前端构建配置：Vite/Webpack 团队把 vite.config.ts 重构为 YAML 后用本工具生成 JSON，让不熟悉 TS 的前端同事用统一 YAML 管理构建配置并被 build 脚本加载。
• Sentry 监控配置：把 Sentry 项目配置 sentry.yml、release-health 配置转为 JSON 后批量导入多个 Sentry 组织，或与 oncall 系统的 webhook JSON 模板合并。
• 在线考试题库：把 YAML 格式的题库（单选、多选、判断、案例分析题）转为 JSON 后存入 MongoDB，供在线考试系统按题型聚合查询和随机组卷。
• 国际化资源协作：产品经理用 YAML 维护多语言文案（zh-CN.yml、en-US.yml），交付前端前先转 JSON 校验键值完整性与嵌套层级，避免 i18n 加载报错。
• CI 流水线调试：CI 工程师本地调试 GitHub Actions 时，把 .github/workflows/*.yml 转 JSON 后用 jq 快速定位环境变量、secrets 引用，方便排查 secret 解析失败。
• API Mock 服务器：后端在响应式接口尚未就绪时，把 OpenAPI YAML 转 JSON 导入 Prism 或 MockServer，自动生成 Mock 响应供前端并行开发。
• Terraform Plan 审计：Terraform 工程师把 plan 输出（plan.yml）转 JSON 后用 jq 过滤敏感字段做最小权限审计，再写回数据库做变更留痕。

使用方法

1. 在左侧输入框粘贴 YAML 内容，或点击「上传」按钮选择 .yaml/.yml/.txt 文件，或点击「示例」加载内置的用户配置示例。
2. 工具会自动转换（输入后 400ms 防抖）；在右侧查看转换后的 JSON，CodeMirror 语法高亮便于阅读。
3. 点击底部工具栏的「格式化输出」复选框可在 pretty（2 空格缩进）和紧凑两种输出模式间实时切换，适配不同应用场景。
4. 如 YAML 有语法错误，点击错误提示旁的「修复结构」按钮，工具会调用 tryFixYAML 自动修复 5 类常见错误，并提示修复内容。
5. 点击「复制」将 JSON 复制到剪贴板，或点击「下载」保存为 converted.json 文件（MIME: application/json）。
6. 将 JSON 粘贴到目标代码（kubectl apply、swagger-codegen、自定义 Node.js 配置加载库等）或导入到后端服务进行进一步处理。

功能特点

• js-yaml 库解析：基于成熟的 js-yaml 库支持所有标准 YAML 1.1 语法（标量、序列、映射、锚点、别名、多行字符串等），无依赖。
• 智能错误修复：内置 tryFixYAML 自动修复 5 类常见 YAML 错误（制表符、未闭合引号、缩进不规范、键名特殊字符、行尾空格）。
• pretty 输出模式：默认 2 空格缩进美化输出，便于阅读和人工编辑；非 pretty 模式输出紧凑单行 JSON，适合网络传输。
• 完整类型支持：支持所有 YAML 标量类型（string、number、boolean、null、date）、序列（array）、映射（object）的双向转换。
• 嵌套结构递归：任意深度的 YAML 嵌套映射和列表会递归转换为对应的 JSON 嵌套对象和数组。
• 锚点别名解析：支持 YAML 锚点（&anchor）和别名（*alias）语法，js-yaml 自动解析引用关系，JSON 中显示展开后的内容。
• YAML 注释忽略：YAML 注释（#）会被自动忽略，转换后的 JSON 是纯数据，不包含注释。
• 实时自动转换：输入 YAML 后 400ms 防抖自动转换，配合键盘快捷键提升操作效率。
• JSON 高亮输出：右侧 CodeMirror JSON 语法高亮，便于阅读复杂 JSON 结构。
• 纯浏览器本地处理：所有 YAML 解析、JSON 序列化、错误修复都在浏览器 JavaScript 中完成，原始配置不上传。
• 历史记录恢复：自动保存最近 200 条历史记录，页面加载时自动恢复上次输入内容。
• 完整快捷键体系：转换、上传、复制、下载、清空等常用操作，遵循主流 JSON/YAML 编辑工具约定。

常见问题

故障排查

术语表

YAML (YAML Ain't Markup Language)

人类友好的数据序列化格式，2001 年由 Clark Evans 等人设计。使用缩进表示层级、支持注释、列表、映射、多行字符串、锚点与别名等特性。是 Kubernetes、Docker Compose、Ansible、GitHub Actions 等现代 DevOps 工具的事实配置标准。

JSON (JavaScript Object Notation)

轻量级数据交换格式，基于 JavaScript 对象语法但独立于编程语言。支持对象 ({}), 数组 ([]), 字符串, 数字, 布尔, null 六种基本类型。是现代 Web API、NoSQL 数据库、JavaScript 生态的事实标准。

js-yaml

成熟的 JavaScript YAML 解析器和序列化器（~50KB），支持 YAML 1.1 完整规范和部分 1.2。本工具基于此库实现 YAML 解析为 JavaScript 对象，再通过 JSON.stringify 序列化为 JSON。

缩进（indentation）

YAML 严格依赖缩进表示层级关系，必须使用空格（不能使用制表符）且缩进必须一致（如 2 空格）。这是 YAML 最常见错误源之一。本工具自动检测和修复缩进问题。

锚点与别名（anchor & alias）

YAML 高级特性。&anchor 定义可被引用的标记，*alias 在其他位置引用该标记。js-yaml 在内部解析时自动展开引用，最终 JSON 中不保留这些标记，只包含展开后的数据。

多行字符串（multiline）

YAML 提供两种多行字符串语法。字面量块（|）保留换行符；折叠块（>）将多个换行折叠为单个空格。js-yaml 正确解析这两种语法，转换到 JSON 时按规范保留或折叠换行。

文档分隔符（document separator ---）

YAML 中三个连续连字符（---）表示文档分隔符，常用于在一个文件中包含多个 YAML 文档。js-yaml 默认只解析第一个文档，多文档解析需特殊处理。

YAML 1.1 vs 1.2

YAML 1.1（2005）广泛部署，支持八进制、性别单字符、Norway 缩写等。YAML 1.2（2009）移除了有歧义特性，与 JSON 更兼容。本工具默认 YAML 1.1 以保证最大兼容性。

锚点（&）

YAML 中 &name 定义一个可被后续 *name 引用的标记，常用于避免在多文档中重复相同配置块。

别名（*）

YAML 中 *name 引用之前用 &name 定义的标记，js-yaml 在解析时会将引用替换为实际内容，最终 JSON 中不含别名信息。

JSON.stringify

JavaScript 内置方法，将对象序列化为 JSON 字符串。本工具使用第 2 个参数（replacer）和第 3 个参数（space）控制缩进：space=2 生成 pretty 输出，space=undefined 输出紧凑单行。

tryFixYAML

本工具内置的 YAML 修复函数，会自动检测和修复 5 类常见错误：制表符转空格、移除行尾空格、闭合未闭合引号、修正非 2 倍数缩进、为包含特殊字符的键名加引号。处理实际项目中不规范的 YAML。

pretty 输出

本工具的可切换输出模式。启用时输出带 2 空格缩进和换行的可读 JSON（便于人工查看）；禁用时输出紧凑单行 JSON（适合 API 传输、存储）。

YAML 到 JSON 类型的映射规则

本工具基于 js-yaml 的 YAML 到 JSON 转换映射规则：

YAML 与 JSON 格式对比

两种格式在不同维度上的对比，帮助理解何时选择 YAML 或 JSON：

常见 YAML 错误和修复

本工具 tryFixYAML 自动检测和修复的 5 类常见 YAML 错误：

Privacy & Security

本 YAML 转 JSON 工具所有操作完全在你的浏览器本地完成：YAML 解析（基于成熟的 js-yaml 库）、JSON 序列化、错误修复（tryFixYAML）全部通过浏览器 JavaScript 在客户端执行，js-yaml 是唯一外部依赖（约 50KB 的 npm 包）。原始 YAML 数据（可能包含敏感配置如 k8s secrets、API 密钥、数据库凭证）不上传到任何服务器。文件上传使用浏览器原生 FileReader API 直接读取到内存，不经过任何中间服务。不使用 Cookie 追踪，不收集任何用户输入或使用数据。关闭或刷新页面后，所有输入和输出内容自动从内存清除。适合处理含敏感配置（k8s secrets、API 密钥、数据库凭证、企业 DevOps 流水线）的 YAML 文件。

Authoritative References

• YAML.orgYAML 1.2 规范
• GitHubjs-yaml GitHub 仓库
• KubernetesKubernetes YAML 参考
• DockerDocker Compose 规范
• AnsibleAnsible YAML 指南
• GitHubGitHub Actions YAML 文档