YAML ↔ JSON 変換

YAMLとJSONの違いと使い分けの完全ガイド

モダンなシステム開発において、データのシリアライズ形式として「YAML」と「JSON」は最も広く使われています。しかし、それぞれにメリットと特有の落とし穴があるため、用途に応じて正しく使い分けることが重要です。このガイドでは、両者の構文の違い、実務での使い分け、パース時の注意点について詳しく解説します。

YAMLとJSONの決定的な違い

JSON (JavaScript Object Notation) は、データ転送を主目的とした軽量なフォーマットです。対して YAML (YAML Ain't Markup Language) は、人間にとっての読み書きのしやすさを最優先に設計されています。実はYAMLはJSONのスーパーセット（完全上位互換）であるため、有効なJSONはすべて有効なYAMLとして解釈されます。

実務での使い分けパターン（Use Cases）

よくある落とし穴（Gotchas）とエラー対策

JSONとYAMLを変換する際、特に手書きで編集しているとしばしばエラーに遭遇します。代表的なミスを知っておきましょう。

1. YAMLのインデントミス

YAMLはPythonのようにインデント（空白文字）でデータ構造を表現します。タブ文字は仕様として禁止されているため、必ず半角スペース（通常は2文字）を使用してください。インデントが1つズレるだけで全く異なるデータ構造になってしまいます。

2. JSONの末尾カンマ（Trailing Comma）

JSONの構文チェックで最も多いエラーがこれです。配列やオブジェクトの最後の要素の後にカンマをつけることは、仕様上許されていません。

{
  "name": "taro",
  "age": 20, /* ← このカンマがあるとJSONParserがエラーを吐く */
}

3. YAMLの暗黙の型変換

YAMLは文字列をクォーテーションなしで書けますが、特定の文字列（true, false, yes, no, on, offなど）は自動的に論理値（Boolean）に変換されます。意図的に文字列として扱いたい場合は、必ず "yes" のようにダブルクォートで囲んでください。ノルウェーの国コード「NO」がパース時にfalseに化けてしまう「Norway Problem」は非常に有名です。

Node.js / Python でのパース方法

Node.js (JavaScript) の場合

JSONはネイティブでサポートされていますが、YAMLを扱うには外部パッケージ（js-yaml等）が必要です。

// JSONのパース（ネイティブ）
const data = JSON.parse('{"key": "value"}');

// YAMLのパース（要 npm install js-yaml）
const yaml = require('js-yaml');
const fs = require('fs');
const doc = yaml.load(fs.readFileSync('config.yml', 'utf8'));

Python の場合

標準ライブラリのjsonに加え、YAMLにはPyYAMLを使用するのが一般的です。

import json
import yaml # pip install pyyaml

# JSONのパース
with open('data.json') as f:
    data = json.load(f)

# YAMLのパース（安全のため safe_load を使用）
with open('config.yml') as f:
    config = yaml.safe_load(f)