YAML 格式化与校验
这个工具能做什么
YAML 没有花括号:结构由缩进承担。这让它读起来舒服,也让它很容易坏 —— 多一个空格,某个键就落到了错误的父节点下。本工具把文档缩进统一成一种宽度,指出哪里坏了,并展示它实际是怎么被读取的。
怎么用
- 1 把 YAML 粘贴到框里,选择缩进宽度 —— 常见的是两个空格。
- 2 点「格式化」重排缩进,或点「校验」在一个字符都不改的情况下检查。
- 3 不确定某个值是否按你的本意被读取?点「转为 JSON」看一眼。
制表符不算缩进
YAML 规范禁止用制表符缩进,多数解析器会直接拒绝这个文件。它们给出的报错很少有用,因为指出的行往往是真正问题的下一行。本工具会直接点名含制表符的那一行。
注释不会丢
很多格式化工具会把文档解析成树再重新输出。结果很整齐,同时把你写的注释全删了 —— 对 docker-compose 或 CI 流水线来说没法用。本工具只重写行首空白,注释、键的顺序和引号写法都保持原样。
为什么 NO 变成了 false
在 YAML 1.1 中,不带引号的 yes、no、on、off 是布尔值。于是含有挪威代码 NO 的国家列表会被读成 false —— 这个坑有名到自带称呼。YAML 1.2 取消了该规则,本工具遵循 1.2:关键字只有 true、false 和 null。想要布尔值就写 true 或 false;想要文本,你已经有了。
锚点、别名与块标量
锚点(&名字)给节点做标记,别名(*名字)稍后可以复用 —— 重复的服务定义里很好用。块标量(| 和 >)承载多行文本:竖线保留你的换行,尖括号把换行折成空格。三者在这里都能识别,并且块标量内部的缩进被当作数据,而不是排版。
YAML 格式化 - 常见问题
不会。「格式化」只重写每行开头的空白。注释、键的顺序、引号以及每个值的文本都逐字节保持你写的样子。如果文档无法解析,它会拒绝格式化,而不是去猜。
最常用的格式化工具
全部时间
新
Markdown 编辑器
编写 Markdown 并并排查看渲染结果。支持标题、列表、表格、代码块和链接;可复制 HTML 或下载 .md 与 .html 文件。在浏览器中运行。
今日热门
Markdown 编辑器
编写 Markdown 并并排查看渲染结果。支持标题、列表、表格、代码块和链接;可复制 HTML 或下载 .md 与 .html 文件。在浏览器中运行。