JSONとYAMLの相互変換イメージ

JSONとYAML：2つのデータ形式

モダンな開発において、データの保存や転送には主にJSONとYAMLが使われます。

JSON (JavaScript Object Notation)

  • 特徴: 軽量でパースが速い。JavaScriptと親和性が高い。
  • 用途: Web API（REST）, フロントエンドのリクエスト/レスポンス。
  • 弱点: コメントが書けない。末尾のカンマに厳しい。

YAML (YAML Ain’t Markup Language)

  • 特徴: 人間が読みやすい（ヒューマンラダブル）。
  • 用途: 設定ファイル（Docker, Kubernetes, GitHub Actions）, CI/CD。
  • 弱点: インデント（空白）に厳格。パースがJSONに比べて複雑。

変換が必要になるケース

  • 設定ファイルの編集: APIで取得したJSON設定を、読みやすいYAML形式に変換してローカルファイルに保存したい場合。
  • データ投入: YAMLで管理している設定を、プログラムで扱うためにJSON形式に変換してAPI経由で送信したい場合。
  • デバッグ: 見づらい1行のJSONをYAMLに変換して、構造を素早く把握したい場合。

実例：API設定をYAMLでレビューする

APIから次のようなJSON設定を受け取ったとします。

{
  "retries": 3,
  "timeoutMs": 30000,
  "features": {
    "csvExport": true,
    "betaDashboard": false
  }
}

レビュー時にYAMLへ変換すると、設定の階層を読みやすくできます。

retries: 3
timeoutMs: 30000
features:
  csvExport: true
  betaDashboard: false

この形なら、タイムアウトがミリ秒なのか、機能フラグがどの階層にあるのかを確認しやすくなります。JSON、CSV、YAMLを行き来する作業では、形式そのものより「誰が何を確認するか」に合わせて見せ方を変えるのが大切です。

DevToolKitsでの相互変換

JSON⇔YAML変換ツール を使用すると、どちらの形式からも双方向にワンクリックで変換できます。
JSONを貼り付ければYAMLに、YAMLを貼り付ければJSONに出力されます。

💡 注意点: 変換時にコメント（YAMLのみ）が消失する場合があるため、純粋なデータ構造の変換として利用するのが最適です。

CSVで受け取った一覧データをJSONへ変換し、設定やAPIレスポンスはYAMLで確認する、というように使い分けると、データ変換の記事群を実務の流れとしてつなげられます。