JSONの整形と最小化(minify)の違いと使い分け

JSON を扱っていると、「整形(pretty print)」と「最小化(minify)」という 2 つの操作をよく目にします。どちらもデータの中身は変えず、見た目(空白と改行)だけを変えるものですが、目的が正反対です。この記事で、違いと使い分けを整理します。

整形(pretty print)とは

整形は、改行とインデントを加えて JSON を人が読みやすい形にする操作です。ネストしたオブジェクトや配列が階層ごとに字下げされ、構造が一目で分かります。API のレスポンスを確認したり、設定ファイルを編集したり、バグを探したりするときに役立ちます。

最小化(minify)とは

最小化は、逆に不要な空白や改行をすべて取り除き、1 行にまとめる操作です。見た目は読みにくくなりますが、ファイルサイズが小さくなるため、通信量の削減や読み込み速度の向上に効きます。本番環境で配信する JSON や、URL・設定値に埋め込む JSON でよく使われます。

データは変わらない

大事なポイントは、整形も最小化も「データ(値)」は一切変えないということです。キーの順序も保持され、変わるのは空白と改行だけです。したがって、整形した JSON と最小化した JSON は、プログラムから見れば完全に同じデータとして扱われます。

使い分けの目安

• 読む・編集する・デバッグする → 整形
• 配信する・保存する・埋め込む(サイズ優先) → 最小化
• 他人に共有する → 相手が読むなら整形、機械が処理するなら最小化

よくあるエラーの原因

整形や検証でエラーが出るときは、末尾のカンマ(trailing comma)、シングルクォート、コメント(// や /*)、キーの引用符抜けなどが原因のことが多いです。標準の JSON はこれらを許可していません。当サイトの JSON整形ツールは、エラー箇所の手がかりを示すので、壊れた JSON の修正にも役立ちます。CSV や YAML との相互変換が必要なら、CSV⇔JSON・YAML⇔JSON ツールも合わせてご利用ください。