ConvertLab.cloud

YAML 是什么格式?

YAML — 可读性配置文件

使用该格式 YAML

一个具体例子

从一个 YAML 文件准备一个 JSON,用于一个需要 JSON 的工具。

有用的检查

注释、锚点和隐式类型并不都有对应物。转换后请检查数值的含义。

选择一种转换

保留原件,并在需要使用该文件的软件或设备上打开结果。

您对该格式的疑问

为什么我的 JSON 在变为 CSV 时会改变结构?

CSV 表示一个行列表。JSON 可以包含无法直接转换的对象和嵌套列表。请转换一份副本,检查字段的表示方式,如果您的使用需要保留其完整结构,请保留 JSON。

如何避免在标识符开头丢失零?

在电子表格中打开 CSV 时,将标识符列导入为文本。自动打开可能会将 00123 转换为 123。在重新保存之前,请检查日期和小数分隔符。

我可以转换包含机密信息的文件吗?

在向服务或支持发送示例之前,请删除密码、API 密钥及其他机密信息。文件处理是在在线进行的。对于不应离开您设备的数据,请使用适当的本地工具。

为什么并非提供所有输出选项?

在所有情况下,格式不是可互换的。ConvertLab 显示其目录中的转换;重命名扩展名并不会改变内容。某些专用输出,如特定 XML 导出或电子表格,被识别为 NoLimit。

01

这是什么?

YAML 是一种为人类阅读和编写而设计的配置文件格式。没有花括号,没有标签:结构完全依靠缩进来体现,就像项目符号列表一样。

它支持注释,这使其成为配置文件的首选格式——相比之下,禁止注释的 JSON 用起来实在令人头疼。

02

历史与由来

YAML 诞生于 2001 年,其初衷十分明确:比 XML 更易读,比现有的配置文件格式更灵活。

如今它已渗透到现代开发的各个环节:持续集成、容器编排、自动化部署。当今的工程师几乎每天都要写 YAML。

03

为什么好用

可读性强,写法简洁,支持注释,处理嵌套结构也十分优雅。

从技术上讲,它是 JSON 的超集:任何 JSON 文件都是合法的 YAML。

04

局限与不足

缩进具有语义,而且禁止使用制表符:多一个空格或用错位置,文件的含义就会改变,甚至变得无效。

它的自动类型转换是个著名的陷阱:在旧版本中,NO(挪威的国家代码)会被解析成布尔值“假”。这类意外让该格式落下了“容易产生歧义”的名声。

05

使用建议

YAML 非常适合手写配置文件。但若用于机器间的数据交换,建议转换成 JSON:更严格、更可预测,不存在类型歧义。

凡是可能被误解的值都应加上引号:oui、non、on、off,以及任何看似数字却并非数字的内容。

在我们位于法国的安全服务器上,几秒内转换您的 YAML。

转换 YAML