TOML vs YAML：为什么 Cargo 选择 TOML？

就叫飞六吧2026-05-04 18:11

YAML 看起来简洁，但它有几个出了名的"坑"：

1. 语法过于复杂 YAML 规范极其庞大（1.2 规范有 80+ 页），边界情况很多，不同解析器行为不一致。

2. 臭名昭著的 Norway 问题

yaml 复制代码

countries:
  - GB
  - IE
  - NO   # 被解析成 false！因为 NO = No = false

布尔值自动推断导致无数 bug。

3. 缩进敏感，容易出错

yaml 复制代码

dependencies:
  serde:
    version: "1.0"
   features: ["derive"]  # 缩进差一格 = 完全不同的结构

4. 隐式类型转换

yaml 复制代码

version: 1.10   # 变成浮点数 1.1，不是字符串 "1.10"
port: 080       # 被当成八进制！

1. 专为配置文件设计，语义清晰、无歧义：

toml 复制代码

[package]
name = "my-app"
version = "1.0.0"  # 明确是字符串

[dependencies]
serde = { version = "1.0", features = ["derive"] }

2. 类型明确，字符串就是字符串，数字就是数字，不会魔法转换。

3. 规范简单，各平台解析结果一致，不会出现"这个 YAML 在 A 工具能用，B 工具报错"的情况。

4. 对包管理场景天然友好，表（Table）结构非常适合描述依赖关系。

总结一句话：YAML 适合人读，但不适合机器无歧义地解析；TOML 两者兼顾，且坑少得多。