JSONの整形・バリデーション完全ガイド — 開発者必須の基礎知識

JSONとは

JSON（JavaScript Object Notation）は、データ交換のための軽量フォーマットです。 Web APIのレスポンス、設定ファイル、データベースのエクスポートなど、 現代の開発で最も広く使われるデータ形式の一つです。

JSONの基本構文

JSONで使えるデータ型は以下の6種類です。

• 文字列 — ダブルクォートで囲む: "hello"
• 数値 — 整数または小数: 42, 3.14
• 真偽値 — true または false
• null — 値がないことを示す
• 配列 — 角括弧で囲む: [1, 2, 3]
• オブジェクト — 波括弧で囲む: {"key": "value"}

よくあるJSONエラーと対処法

1. 末尾カンマ（trailing comma）

配列やオブジェクトの最後の要素にカンマを付けるとエラーになります。 JavaScriptでは許容されますが、JSONの仕様では禁止されています。

2. シングルクォートの使用

JSONではダブルクォートのみが有効です。Pythonの辞書をそのままコピーすると、 シングルクォートのせいでパースエラーになることがあります。

3. コメントの記述

JSON仕様ではコメントは使えません。設定ファイルでコメントが必要な場合は、 JSON5やJSONCなどの拡張フォーマットを検討してください。

JSON整形ツールの活用

APIレスポンスやログに含まれるJSONは、1行に圧縮されていることが多く、 人間が読むには不便です。整形ツールを使うことで、インデントが付いた 読みやすい形式に変換できます。

当サイトのJSON整形ツールでは、 2スペース・4スペースのインデント整形に加え、1行への圧縮（minify）にも対応しています。 構文エラーがある場合は、エラーメッセージで原因を特定できます。

まとめ

JSONは構文がシンプルですが、細かいルール（ダブルクォート必須、末尾カンマ禁止など）を 忘れるとパースエラーになります。整形ツールを使えば、視認性の向上だけでなく、 構文エラーの早期発見にも役立ちます。