关于 YAML 查看器
YAML 查看器在浏览器本地将 YAML 数据解析后渲染成可折叠的树形结构,帮助你清晰查看嵌套层级关系。YAML 依靠缩进表达层级,文件一长就很难判断某个键属于哪一层,本工具通过逐层折叠展开解决这一问题。支持标量、序列、映射、锚点和别名引用的解析与展示,配合语法高亮区分键名、字符串、数字、布尔值和注释。关于缩进值得强调:YAML 对缩进极其敏感,同级元素必须严格对齐且不能混用 Tab,正因为如此,树形视图非常适合排查"键到底缩进了几层"这类问题。适用于查看 Kubernetes 配置、CI/CD 流水线定义、Docker Compose 文件和 Spring Boot 配置。支持全文搜索快速定位键名或值,折叠状态下仍可搜索并自动展开匹配节点所在的路径层级。遇到锚点与别名时先展开对应节点确认实际取值,避免误改一处影响多处引用;排查配置问题时可先用全文搜索跳转到目标键,再折叠无关分支,比在纯文本里数缩进层级要省时也可靠。
面对一份几百行的 YAML 配置,靠肉眼逐层缩进找某个键是否容易看错层级,尤其是缩进宽度不统一或存在多行字符串时。查看工具把配置解析成可折叠的树形结构,让「这个键属于哪一段」变成一眼可见的事实,同时把解析错误精确定位到行列,省去反复猜测的时间。 解析原理是把文本按缩进层级构造对象树,因此缩进的一致性是全部前提:制表符与空格混用、或同级元素缩进宽度不一致,都会让解析失败或产出与直觉不同的结构。解析错误提示通常只给出位置而不解释原因,因为解析器在遇到异常时无法判断用户「本来想写什么」,这也是这类报错常被误认为难以理解的原因。 使用要点:排查解析失败时先把制表符全部替换为空格,再设置编辑器显示空白字符,多数问题会立刻现形;其次检查多行字符串的缩进——竖线形式会保留换行与缩进,大于号形式会折叠换行为空格,两者在与后续内容的相对缩进上要求不同,写错时内容会被静默改变而不是报错。展开折叠时注意观察层级深度,过深的嵌套通常意味着某处缩进多了一格。 边界与限制:查看器只负责展示,不做语义校验——必填项缺失、字段名拼错、值超出允许范围都不会报错,因此「能正常显示」不等于「配置正确」。此外重复键在部分解析器中是后者覆盖前者,在另一些解析器中直接报错,同一份文件在不同工具下表现不同,跨系统使用时应避免重复键并在自动化检查中加入该项。锚点与别名解析后会展开显示,阅读时容易误以为内容真的重复了多次。 数据与隐私:需要查看的配置通常含密钥与连接串。本工具在浏览器内完成解析与展示,不上传内容,可离线使用;若要排查的是生产配置,建议先复制副本并替换敏感值,再放入查看器分析结构。
实现原理
查看器把文本按缩进解析成对象树,因此缩进的一致性是全部前提:混用制表符与空格、或同级元素缩进不同,会解析失败或产出与直觉不同的结构。解析错误提示通常只给位置不解释原因,因为解析器无法判断作者本来想写什么。展开显示时锚点会被还原成重复内容。
a:\n b: 1\n c: 2同一层级的 b 与 c 缩进不同 → 解析失败或把 c 归入错误层级;错误提示只给出所在行使用方法
- 打开「YAML 查看器」
- 输入或粘贴待处理的内容
- 根据需要调整输出选项
- 点击「运行」按钮,结果实时显示
- 复制或导出结果
使用场景
- 审阅 K8s 清单 — 把冗长的 Deployment/Service YAML 渲染成树,快速核对各层配置。
- 理解 CI 配置 — 展开 GitHub Actions / GitLab CI 的 YAML,看清 job、step 的层级关系。
- 排查缩进问题 — 当 YAML 行为不符预期时,用树形视图确认某个键到底缩进在哪一层。
- 查看锚点结构 — 直观看到 YAML 锚点和引用展开后的实际结构。
- 浏览大型配置 — 折叠无关段落,专注查看目标配置块。
- 追踪依赖链 — 折叠展开 docker-compose 各服务层级,理清 depends_on 与挂载关系。
常见问题
支持多文档 YAML 吗?
支持。用 --- 分隔的多个文档会被分别解析并在树中分块展示。
锚点和引用怎么显示?
本工具会展开锚点引用,让你看到引用处实际生效的完整内容。
会修改我的 YAML 吗?
不会。仅做只读解析和渲染,不改动原始内容。
为什么解析失败?
通常是缩进不一致或混用了 Tab。YAML 对缩进非常敏感,错误提示会帮你定位。
可以搜索折叠中的节点吗?
可以。全文搜索会命中折叠状态下隐藏的键值,并自动展开匹配节点所在路径,方便直接跳到目标。
想转成 JSON 查看?
可以使用「YAML 转 JSON」工具,再用「JSON 查看器」浏览。
YAML 里 TAB 缩进报错,但我看不出来哪里有 TAB?
YAML 禁止 TAB 缩进,而 TAB 与空格在多数编辑器里视觉相同。用编辑器的「显示空白字符」功能定位;从聊天工具或网页复制来的 YAML 最容易夹带 TAB。全选替换为空格是最快的修法。
预览树里数组显示成编号键(0、1、2),正常吗?
正常。YAML 的列表在树形视图里按索引展示,与 JSON 数组的显示一致。数据本身是数组而不是对象,复制或导出时输出的是标准数组结构,不会带这些编号键。