JSONを整形する3つの確実な方法：読みやすく・検証も同時に（2026年ガイド）

「JSONを整形する」とは実際何をすることか

APIやログファイルから来るJSONは、しばしばミニファイされています：文書全体がスペースなし1行に押し込められた状態です。依然として正当なJSONですが、人間には読めません。整形（プリティプリント、美化とも呼ばれます）は、それをインデント付きの複数行に展開し直し、構造を見えるようにします：オブジェクトの中のオブジェクト、アイテムの配列、それぞれがどこで終わるか。

検証と混同されがちですが、両者はたいていセットです。検証は「正しいJSONか？」に答え、整形は「人間が読めるか？」に答えます。良い整形ツールは両方を一度に行います：JSONに構文エラーがあれば、黙ってゴミを出すのではなく、整形を止めて行番号を指し示します。

方法1：無料のオンライン整形ツール（最速）

APIのレスポンスやログを一度だけ整形したいなら、オンラインツールが最速です：インストール不要、コード不要。ブラウザ内だけで動作する（クライアントサイド）ツールを選んでください。データがデバイスから外に出ません。トークンやメールアドレスなど機密情報を含むJSONでは特に重要です。

JSONを整形ツールに貼り付けます（.json ファイルのドロップも可）。
「整形」をクリック：ツールがインデントを適用し、構文を色分けして、エラーがあれば行番号付きで表示します。
整形後の出力をコピーしてエディタに戻すか、本番用にコンパクト版が必要なら「ミニファイ」ボタンを使います。

方法2：コードエディタ（毎日の習慣に）

JSONを日常的に触るなら、エディタ内での整形がキー1つです。VS Codeでは .json ファイルを開いて Shift+Alt+F（Windows/Linux）または Shift+Option+F（Mac） —「ドキュメントのフォーマット」です。「保存時にフォーマット」を有効にすれば自動化もできます。

高度なJSON作業にはプラグインが必要なエディタもありますが、基本的な整形は VS Code、Sublime Text（パッケージ経由）、JetBrains の IDE に標準搭載されています。

方法3：ターミナルコマンド（再現性あり）

JSONがファイルにあり、スクリプトやデプロイ手順の中で毎回同じ結果が欲しい場合 — コマンドラインのワンライナーがクリックより確実です。

ターミナル

# data.json を整形してターミナルに表示
python3 -m json.tool data.json

# 整形版を新しいファイルに書き出す
python3 -m json.tool data.json > data.pretty.json

# jq が入っていればこちらも
jq . data.json

python3 -m json.tool は検証もします：ファイルが正しいJSONでないとエラー終了し、行番号を示します。スクリプト内の簡易チェックに便利です。

整形版とミニファイ版：使い分け

整形版のJSONは人間のため：デバッグ、手で編集する設定ファイル、ドキュメントの例。ミニファイ版は機械のため：APIレスポンス、本番用ファイル、バイト数とパース速度が重要なもの。

両者は自由に行き来できます — データは同じです。ただしミニファイ版を直接手編集するのは避けましょう：まず展開して変更し、受け手がコンパクト版を必要とする場合のみ再びミニファイします。

整形で見つかるよくあるエラー

10回中9回、整形ツールの「失敗」はそれ自体が最大の収穫です。いつも見つかる犯人はこちら：

末尾のカンマ — {"a": 1,} はJSONでは違法です（JavaScriptではOK）。閉じ括弧の前のカンマを削除します。
シングルクォート — JSONの文字列はダブルクォートが必要です。'値' を "値" に置き換えます。
コメント — // や /* */ はJSONの一部ではありません。削除するか、ツールが対応していれば JSONC/JSON5 に切り替えます。
クォートなしのキー — {name: "x"} は {"name": "x"} にする必要があります。
コピペ破損 — チャットアプリや文書からの全角クォート（“ ”）は正しい引用符ではありません。半角のストレートクォートに置き換えます。

次のステップ：整形したJSONを表計算ソフトへ

JSONが読みやすく正当になったら、次はたいてい表計算ソフトへの取り込みです — そこが無料コンバーターの出番です：JSONを数秒でクリーンなCSVに変換します。アップロードなしのプライバシー重視はそのままです。

読む：JSONをCSVに変換する方法

よくある質問

整形とJSONの検証は同じですか？

違いますが、重なります。検証はJSONが構文ルールに従っているかを調べ、整形は人間が読めるようインデントと改行で書き直します。ほとんどの整形ツールは先に検証します — 構文エラーのある文書は整形しません。だから整形の失敗はたいてい「JSONが不正」という意味です。

整形するとデータは変わりますか？

変わりません。整形が変えるのは空白だけ：インデント、改行、スペースです。キー、値、順序、型はそのままです — ただしキーソートのような追加機能を明示的に有効にした場合は別です（別オプションとして提供されることが多い機能です）。

整形時に「Unexpected token」と出るのはどういう意味ですか？

パーサーが置き場のない文字に当たったという意味です — ほぼ確実に末尾カンマ、シングルクォート文字列、クォートなしキー、チャットアプリから貼り付けた全角クォートのいずれかです。エラーメッセージには位置が含まれるのが普通です。その箇所を直して再整形すれば、次のエラー（あれば）が表示されます。

何もインストールせずにJSONを整形できますか？

できます。ブラウザで動く無料のオンライン整形ツールか、Pythonが入っていれば python3 -m json.tool のワンライナーを使います。VS Codeも .json ファイルを Shift+Alt+F で標準で整形できます。

オンライン整形ツールにJSONを貼り付けるのは安全ですか？

たいていは大丈夫ですが、ブラウザ内だけで処理する（クライアントサイド）ツールを選んでください — そうすればサーバーに何も送信されません。APIキーや個人情報など、メールで送りたくない内容が含まれる場合は、エディタかターミナルコマンドを使いましょう。

ミニファイされたJSONとは何ですか？

不要な空白をすべて取り除いたJSON：文書全体が1行です。APIや本番ファイルで使われるのは、サイズが小さくパースもわずかに速いからです。正当なJSONですが、人間の目用ではありません。どの整形ツールでも読みやすい版に戻せます。

巨大なJSONファイルも整形できますか？

できますが、限界があります。ブラウザ型の整形ツールは数MB程度までなら大丈夫ですが、それ以上ではタブが固まることがあります。大きなファイルは python3 -m json.tool や jq でローカル整形しましょう。大きなファイルも軽々処理できます。