YAMLをJSONに変換する方法|手作業のルールと注意点

公開ツールYAML → JSON 変換ツール

目次
  1. YAML の設定は、なぜコードでつまずくのか
  2. 確認する方法: 手作業で変換するルールと検証
  3. よくつまずくポイント
  4. まとめ
  5. よくある質問

設定ファイルは YAML で書いておくことが少なくありません。インデントだけで構造が見え、コメントも自由に書けるので、人が読んで直す分には YAML のほうがずっと楽です。ところが、その値を JavaScript のコード内で使ったり、API リクエストの本文にそのまま入れようとした瞬間、YAML のままでは使えないことに気づきます。

まとめ ① YAML は人が読み書きしやすい一方、JavaScript のオブジェクトや API リクエスト本文は JSON 形式を前提としています ② インデントによる構造を波かっこ・角かっこによる構造へ移すルールさえ分かれば、手作業でも変換できます ③ ネストが深い YAML やリストが混ざった YAML は手作業での変換ミスが起きやすいため、結果を目で検証する工程が必要です

YAML の設定は、なぜコードでつまずくのか

YAML はインデントで階層を表し、コロンの後ろに値を書く方式なので、人が読むのに向いています。コメント(#)も自由に書けるため、設定ファイルの形式として広く使われています。

問題は、JavaScript の JSON.parse や fetch のリクエスト本文などが、YAML の文法を理解しないという点です。これらの関数が解釈できるのは、JSON 文法である波かっこ、角かっこ、二重引用符で囲んだキーだけです。

そのため、設定ファイルにある値をテスト用の API リクエストにそのまま貼り付けたり、フロントエンドのコード内に定数として移そうとしたりすると、構文エラーになります。YAML 自体は文法的に何の問題もないのに、JSON を前提とする場所ではエラーになるわけです。

確認する方法: 手作業で変換するルールと検証

手作業で変換するときのルールは 3 つです。1 つ目は、key: value を二重引用符で囲んだ形に変えること。2 つ目は、インデントで表された下位項目を波かっこで囲むこと。3 つ目は、行頭に付くリスト項目を角かっこの配列に変えることです。

YAML 表記JSON 表記
host: localhost二重引用符で囲んだキーと値
インデントでまとめた下位項目波かっこで囲む
行頭のリスト項目角かっこの配列に変える
true、false、null、数値引用符なしでそのまま維持

ルールは単純ですが、階層が 2〜3 段を超えると、かっこの対応を手で合わせるのは簡単ではありません。リストの中にさらにオブジェクトが入っている構造なら、かっこが重なってミスが起きやすくなります。

当サイトの無料ツールで確認する。 YAML を入力欄に貼り付けると、下に JSON の結果がすぐに作られ、インデント幅を 2 スペース・4 スペース・1 行(圧縮)から選んで、そのままコピーしてコードに貼り付けられます。

YAML → JSON 変換ツール

無料・登録不要・ブラウザ上ですぐにJSON変換

よくつまずくポイント

状況なぜつまずくのか
リストの中にオブジェクトが混ざった構造角かっこの中に波かっこが重なり、手で対応を合わせるのが難しいからです
文字列にコロンや引用符が含まれるエスケープ処理をしないと構文エラーになります
タブとスペースを混ぜたインデント階層の解釈が変わり、意図しない構造に変換されます
最後の項目の後ろにカンマが残っているJSON は最後の項目の後ろのカンマを許可していません

表にまとめた状況は、目で流し見しただけではなかなか気づけず、実際にパースを試して初めてエラーの位置が見えます。変換後には、構造が元と同じかどうかを一度確認する習慣が必要です。

まとめ

YAML は設定を人が読み書きしやすい形式で、JSON はコードと API が理解する形式です。コロンを引用符に、インデントを波かっこに、リストを角かっこに変えれば、手作業でも移せます。

ただし階層が深くなったり、リストとオブジェクトが混ざったりすると、かっこの対応を合わせる途中でミスをしがちです。そんなときは、変換結果をその場で目視検証できるツールを使ったほうが早く済みます。

YAML → JSON 変換ツール

無料・登録不要・ブラウザ上ですぐにJSON変換

よくある質問

YAML のすべての文法を JSON に変換できますか?

key-value、ネストしたマップ、リストのように設定ファイルでよく使う構造は、そのまま JSON に移せます。ただしアンカーや参照といった YAML 固有の文法は JSON に対応する概念がないため、先に値を展開した状態にしてから変換する必要があります。

変換した JSON は API リクエスト本文にそのまま使えますか?

標準的な JSON 構造になっていれば、fetch や axios のリクエスト本文にそのまま入れられます。ただし、API が期待するフィールド名や値の型が元の YAML のキーと一致しているかは、別途確認が必要です。

インデント幅は 2 スペースと 4 スペースのどちらを選べばよいですか?

パースされたデータ自体は、インデント幅に関係なく同じです。共同作業中のコードベースに貼り付ける予定なら、そのプロジェクトが使っている幅に合わせればよく、API リクエスト本文のように空白が重要でない場所では 1 行(圧縮)オプションのほうが便利です。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. YAMLのインデントエラーでCIデプロイが失敗する原因と直し方GitHub Actions や GitLab CI の設定ファイルで、スペース1つ分のずれがデプロイ失敗を招く理由と、ずれた行番号をすぐ見つける方法を解説します。
  2. YouTube字幕をSRT・VTTで保存 — 自動生成と手動の違いYouTubeの自動生成字幕が人名や専門用語で誤る理由、手動字幕との違い、SRT・VTT・TXTの使い分けをまとめました。
  3. テキストの各行に行番号を付ける方法 5形式と桁揃え複数行のテキストやコードの先頭に、1. や [1]、01. など5つの形式で行番号を自動で付けられます。空行を除く方法と、桁数を揃える計算の仕組みも解説します。
  4. アナグラム判定の方法 4ステップで一致を確認2つの単語や文がアナグラムかどうかを、大文字小文字・空白・記号を除いて文字を並べ替え、4ステップで確かめる方法を解説します。文字の出現回数を数える高速な判定の仕組みと、身近な例もあわせて紹介します。
  5. NGワードの伏字変換 誤検出を防ぐ判定の仕組み部分一致と完全一致の違い、長い単語を優先するマッチング、スカンソープ問題の避け方まで、誤検出の少ない伏字処理の考え方を整理して解説します。
  6. Base32エンコードの仕組みとOTPシークレットキーのデコードRFC 4648準拠のBase32が5ビット単位で変換される仕組み、0・1・8・9を使わない理由、=パディングの計算方法、そしてGoogle OTPのシークレットキーをデコードする手順までを解説します。

関連ツール