
YAML 是什么格式?
YAML — 可读性配置文件
使用该格式 YAML
一个具体例子
从一个 YAML 文件准备一个 JSON,用于一个需要 JSON 的工具。
有用的检查
注释、锚点和隐式类型并不都有对应物。转换后请检查数值的含义。
选择一种转换
保留原件,并在需要使用该文件的软件或设备上打开结果。
您对该格式的疑问
为什么我的 JSON 在变为 CSV 时会改变结构?
CSV 表示一个行列表。JSON 可以包含无法直接转换的对象和嵌套列表。请转换一份副本,检查字段的表示方式,如果您的使用需要保留其完整结构,请保留 JSON。
如何避免在标识符开头丢失零?
在电子表格中打开 CSV 时,将标识符列导入为文本。自动打开可能会将 00123 转换为 123。在重新保存之前,请检查日期和小数分隔符。
我可以转换包含机密信息的文件吗?
在向服务或支持发送示例之前,请删除密码、API 密钥及其他机密信息。文件处理是在在线进行的。对于不应离开您设备的数据,请使用适当的本地工具。
为什么并非提供所有输出选项?
在所有情况下,格式不是可互换的。ConvertLab 显示其目录中的转换;重命名扩展名并不会改变内容。某些专用输出,如特定 XML 导出或电子表格,被识别为 NoLimit。
这是什么?
YAML 是一种为人类阅读和编写而设计的配置文件格式。没有花括号,没有标签:结构完全依靠缩进来体现,就像项目符号列表一样。
它支持注释,这使其成为配置文件的首选格式——相比之下,禁止注释的 JSON 用起来实在令人头疼。
历史与由来
YAML 诞生于 2001 年,其初衷十分明确:比 XML 更易读,比现有的配置文件格式更灵活。
如今它已渗透到现代开发的各个环节:持续集成、容器编排、自动化部署。当今的工程师几乎每天都要写 YAML。
为什么好用
可读性强,写法简洁,支持注释,处理嵌套结构也十分优雅。
从技术上讲,它是 JSON 的超集:任何 JSON 文件都是合法的 YAML。
局限与不足
缩进具有语义,而且禁止使用制表符:多一个空格或用错位置,文件的含义就会改变,甚至变得无效。
它的自动类型转换是个著名的陷阱:在旧版本中,NO(挪威的国家代码)会被解析成布尔值“假”。这类意外让该格式落下了“容易产生歧义”的名声。
使用建议
YAML 非常适合手写配置文件。但若用于机器间的数据交换,建议转换成 JSON:更严格、更可预测,不存在类型歧义。
凡是可能被误解的值都应加上引号:oui、non、on、off,以及任何看似数字却并非数字的内容。
在我们位于法国的安全服务器上,几秒内转换您的 YAML。
转换 YAML