YAML vs TOML：你應該選擇哪種設定格式？

YAML 和 TOML 都是人類可讀的設定格式，但它們採用了根本不同的方法。YAML 使用縮排來表示結構；TOML 使用 INI 風格的標題和明確的鍵值語法。正確的選擇取決於你的專案、團隊和生態系統。

語法比較

相同設定在兩種格式中的樣子

YAML：

database:
  host: localhost
  port: 5432
  name: myapp
  ssl: true
  pool:
    min: 5
    max: 20
  
server:
  host: 0.0.0.0
  port: 8080
  workers: 4
  cors:
    origins:
      - https://example.com
      - https://api.example.com

TOML：

[database]
host = "localhost"
port = 5432
name = "myapp"
ssl = true

[database.pool]
min = 5
max = 20

[server]
host = "0.0.0.0"
port = 8080
workers = 4

[server.cors]
origins = [
  "https://example.com",
  "https://api.example.com"
]

主要差異

特性	YAML	TOML
結構	基於縮排	區段標題
字串引號	通常可省略	總是需要
型別推斷	積極（有風險）	明確
註解	`#`（單行）	`#`（單行）
多行字串	`\|` 和 `>` 區塊	三引號區塊
日期/時間支援	ISO 8601 字串	原生 datetime 類型
錨點/別名	有	無
巢狀深度	無限（實用上）	無限（深度巢狀時冗長）
表格陣列	映射的序列	`[[section]]` 語法
規範	龐大、複雜	小巧、簡單

型別安全

YAML 的型別推斷問題

YAML 積極地推斷型別，導致微妙的錯誤：

version: 1.0     # 浮點數，不是字串 "1.0"
country: NO      # 布林值 false，不是字串 "NO"
port: '080'       # 八進位數字 64，不是字串 "080"
on: true         # 布林值，不是字串 "on"

TOML 的明確型別

TOML 要求明確的語法，防止型別混淆：

version = "1.0"   # 字串（需要引號）
country = "NO"    # 字串（需要引號）
port = "080"      # 字串（需要引號）
on = true         # 布林值（無歧義）

TOML 有原生的日期和時間型別：

created = 2024-01-15  # DateTime（原生型別）
date-only = 2024-01-15             # Date
time-only = 10-30-00               # Time

生態系統支援

YAML 佔主導地位

Docker Compose
Kubernetes
GitHub Actions
Ansible
CI/CD 流水線（CircleCI、GitLab CI、Travis CI）
雲端服務（AWS CloudFormation、Azure）
大多數 DevOps 工具

TOML 正在成長

Rust（Cargo.toml）
Python（pyproject.toml、PEP 518）
Go（go.mod 使用自訂格式，但設定用 TOML）
Hugo（網站設定）
Netlify
pip（pyproject.toml）

JSON 設定（對照參考）

Node.js（package.json、tsconfig.json）
VS Code 設定
ESLint、Prettier
大多數 JavaScript 工具

何時使用 YAML

DevOps 和基礎設施：Kubernetes、Docker、CI/CD——生態系統需要它
複雜的巢狀結構：YAML 更自然地處理深度巢狀
使用錨點重複利用：透過錨點和別名實現 DRY 設定
團隊慣例：如果你的團隊已經廣泛使用 YAML

若需要 YAML 相關協助，我們的 YAML 格式化工具和 YAML 驗證器是必備工具。

何時使用 TOML

Python 專案：pyproject.toml 是標準
Rust 專案：Cargo.toml 是標準
簡單的設定：扁平或淺層巢狀的設定
型別安全很重要時：TOML 的明確引號可防止型別混淆
新專案：如果不受生態系統限制，TOML 對設定檔來說更安全

何時兩者都不用

機器產生的設定：使用 JSON（解析最快、格式最嚴格）
有結構描述的應用程式設定：使用 JSON 搭配 JSON Schema 驗證
資料交換：API 用 JSON，表格資料用 CSV

常見問題

可以在 YAML 和 TOML 之間轉換嗎？

可以，但有注意事項。YAML 的錨點、別名和複雜型別等功能在 TOML 中沒有對應物。簡單的鍵值和巢狀設定可以順利轉換。yj（YAML 轉 JSON）搭配 toml-cli 等工具可以處理基本轉換。

TOML 會取代 YAML 嗎？

不太可能。YAML 在 DevOps 生態系統（Kubernetes、Docker、CI/CD）中根基太深。TOML 在應用程式設定（Rust、Python）方面正在崛起，因為在這些場景中型別安全比深度巢狀更重要。這兩種格式很可能會共存，各自在其生態系統中佔主導地位。