关于 YAML 查看器
YAML 查看器在浏览器本地将 YAML 数据解析后渲染成可折叠的树形结构,帮助你清晰查看嵌套层级关系。YAML 依靠缩进表达层级,文件一长就很难判断某个键属于哪一层,本工具通过逐层折叠展开解决这一问题。支持标量、序列、映射、锚点和别名引用的解析与展示,配合按值类型着色区分字符串、数字、布尔值与空值。关于缩进值得强调:YAML 对缩进极其敏感,同级元素必须严格对齐且不能混用 Tab,正因为如此,树形视图非常适合排查"键到底缩进了几层"这类问题。适用于查看 Kubernetes 配置、CI/CD 流水线定义、Docker Compose 文件和 Spring Boot 配置。支持按键名或值筛选,搜索时自动忽略折叠状态并高亮匹配行,可直接定位目标。遇到锚点与别名时先展开对应节点确认实际取值,避免误改一处影响多处引用;排查配置问题时可先用筛选定位目标键,再折叠无关分支,比在纯文本里数缩进层级要省时也可靠。
面对一份几百行的 YAML 配置,靠肉眼逐层缩进找某个键是否容易看错层级,尤其是缩进宽度不统一或存在多行字符串时。查看工具把配置解析成可折叠的树形结构,让「这个键属于哪一段」变成一眼可见的事实,同时把解析错误精确定位到行列,省去反复猜测的时间。
解析原理是把文本按缩进层级构造对象树,因此缩进的一致性是全部前提:制表符与空格混用、或同级元素缩进宽度不一致,都会让解析失败或产出与直觉不同的结构。解析错误提示通常只给出位置而不解释原因,因为解析器在遇到异常时无法判断用户「本来想写什么」,这也是这类报错常被误认为难以理解的原因。
使用要点:排查解析失败时先把制表符全部替换为空格,再设置编辑器显示空白字符,多数问题会立刻现形。其次检查多行字符串的缩进——竖线形式会保留换行与缩进,大于号形式会折叠换行为空格,两者在与后续内容的相对缩进上要求不同,写错时内容会被静默改变而不是报错。展开折叠时注意观察层级深度,过深的嵌套通常意味着某处缩进多了一格。
边界与限制:查看器只负责展示,不做语义校验——必填项缺失、字段名拼错、值超出允许范围都不会报错,因此「能正常显示」不等于「配置正确」。此外重复键在部分解析器中是后者覆盖前者,在另一些解析器中直接报错,同一份文件在不同工具下表现不同,跨系统使用时应避免重复键并在自动化检查中加入该项。锚点与别名解析后会展开显示,阅读时容易误以为内容真的重复了多次。需要查看的配置通常含密钥与连接串。本工具在浏览器内完成解析与展示,不上传内容,可离线使用;若要排查的是生产配置,建议先复制副本并替换敏感值,再放入查看器分析结构。
实现原理
解析分两步:先按缩进与标点切出记号(键、值、块的开始与结束),再按层级装配成对象树。缩进不一致会让记号流本身出错,所以报错位置通常指向第一个「看起来不对」的行,而不是真正写错的那一行——这也是这类报错常被误认为难以理解的原因。
a:\n b: 1\n c: 2同一层级的 b 与 c 缩进不同 → 解析失败或把 c 归入错误层级;错误提示只给出所在行本页实测数据
| Tab 缩进报错原文 | tab characters must not be used in indentation (2:1)——行号指向 Tab 所在行 |
|---|---|
| 重复键行为 | duplicated mapping key (2:1):直接报错,不是静默覆盖 |
| js/function 注入 | unknown tag !<tag:yaml.org,2002:js/function>:危险标签被拒绝(js-yaml 默认 Schema 不含它) |
| 断网解析 | DevTools offline 下粘贴仍正常展开(3 行样例) |
| 近 90 天 Google 表现 | 点击 22 次 / 曝光 98 次 / CTR 22.4% |
| 树形视图(2026-11-03 实测) | 全部折叠后可见行数 11→1,展开后恢复;搜索 port 高亮 2 行,无匹配时给出提示 |
解析器是 js-yaml,报错的行号指向的常常是「出问题的那一行」而不是你直觉里的上一行——Tab 缩进的报错 (2:1) 指向第 2 行行首,重复键 (2:1) 指向第二个 k 所在行。两个高频错误都带精确行列号,把报错原文贴进编辑器对着的行看,比自己逐行猜快得多。
使用方法
- 打开「YAML 查看器」
- 把 YAML 贴进左侧编辑器
- 右侧即时生成可折叠的层级树
- 用搜索框筛选键名或值,命中行会高亮
- 缩进有错时顶部直接给出报错信息
- 点「复制 JSON」可导出等价结构
使用场景
- 审阅 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] 这样的索引,正常吗?
正常。YAML 的列表在树形视图里按索引展示,与 JSON 数组的显示一致。数据本身是数组而不是对象,复制或导出时输出的是标准数组结构,不会带这些索引前缀。