JavaScript Object Notation
JSON（.json）ファイル形式の完全ガイド
JSONとは何か？概要と歴史
JSON（JavaScript Object Notation）は、人間にも機械にも読み書きしやすい軽量なデータ交換フォーマットです。拡張子は.jsonで、テキストベースの構造化データを表現するために広く利用されています。その名前にはJavaScriptが含まれていますが、JSONはプログラミング言語に依存しない汎用フォーマットであり、Python、Ruby、Java、PHPなど、ほぼすべての現代的なプログラミング言語でサポートされています。
JSONの起源は2000年代初頭に遡ります。アメリカのソフトウェアエンジニアであるダグラス・クロックフォード（Douglas Crockford）が、JavaScriptのオブジェクトリテラル記法を基にこのフォーマットを考案・普及させました。2006年にRFC 4627として最初に標準化され、その後2013年にECMA-404として、2017年にはRFC 8259として改訂・標準化されました。XMLが主流だった時代に、よりシンプルで軽量な代替手段として登場し、特にWebアプリケーションのAPIにおいてXMLを急速に置き換えていきました。
現在ではWebサービス、モバイルアプリ、設定ファイル、データベースなど、あらゆる分野でデータのやり取りに使用される事実上の標準フォーマットとなっています。
技術仕様
JSONは非常にシンプルな仕様で構成されています。ファイルはUTF-8エンコーディングで記述されるのが標準であり、BOM（バイトオーダーマーク）は付けないことが推奨されています。MIMEタイプはapplication/jsonです。
JSONが扱えるデータ型は以下の6種類です。
- 文字列（String）：ダブルクォーテーションで囲まれたUnicode文字列。例：
"こんにちは" - 数値（Number）：整数または浮動小数点数。例：
42、3.14 - 真偽値（Boolean）：
trueまたはfalse - null：値が存在しないことを示す特別なリテラル
- 配列（Array）：角括弧で囲まれた順序付きリスト。例：
[1, 2, 3] - オブジェクト（Object）：波括弧で囲まれたキーと値のペアの集合。例：
{"name": "太郎", "age": 30}
JSONはコメントをサポートしていないため、設定ファイルとして使用する際には注意が必要です。また、バイナリデータを直接扱うことはできず、Base64エンコーディングなどを経由して文字列として埋め込む必要があります。圧縮については、JSONファイル自体に圧縮機能は内蔵されていませんが、GZIPなどの外部圧縮と組み合わせることで、ファイルサイズを大幅に削減できます。
主な用途
JSONは現代のソフトウェア開発において非常に幅広い場面で活用されています。
- Web APIのデータ交換：REST APIにおけるリクエスト・レスポンスのボディとして最も広く使われています。TwitterやGitHub、Google Maps APIなど、主要なWebサービスのAPIはほぼすべてJSONを採用しています。
- 設定ファイル：アプリケーションの設定を記述するファイル形式として使用されます。Node.jsのpackage.json、Visual Studio CodeのSettings.json、ESLintの設定ファイルなどが代表例です。
- データストレージ：MongoDBやFirestoreなどのNoSQLデータベースは、JSONに似た形式（BSONやJSONドキュメント）でデータを保存します。
- データのシリアライズと転送：アプリケーション間でオブジェクトや構造化データをシリアライズして転送する際に利用されます。
- ログファイル：構造化ログとしてJSONフォーマットを採用するシステムも増えており、ログの解析や検索が容易になります。
メリットとデメリット
| メリット | デメリット |
|---|---|
| 人間が読みやすく、理解しやすいテキスト形式 | コメントが書けないため、設定ファイルとしては不便な場合がある |
| ほぼすべてのプログラミング言語でパーサーが利用可能 | バイナリデータを直接表現できない |
| XMLに比べて冗長性が低く、ファイルサイズが小さい | 大量データの処理においてはCSVなどよりサイズが大きくなることがある |
| Web標準として広くサポートされており、ブラウザのJavaScriptでネイティブに扱える | スキーマ定義が標準仕様に含まれていない（JSON Schemaは別途必要） |
| シンプルな仕様のため、学習コストが低い | 末尾カンマや重複キーなど、パーサーによって挙動が異なる場合がある |
JSONファイルを開く・閲覧する方法
JSONファイルはプレーンテキストであるため、多くのソフトウェアで開くことができます。以下に主なツールを紹介します。
- テキストエディタ：メモ帳（Windows）、テキストエディット（macOS）などの基本的なテキストエディタで開けます。ただしシンタックスハイライトはありません。
- 高機能コードエディタ：Visual Studio Code、Sublime Text、Atom、Notepad++などは、JSONのシンタックスハイライトや自動整形機能を備えており、大きなファイルでも快適に編集できます。
- 統合開発環境（IDE）：IntelliJ IDEA、WebStorm、PyCharmなどのIDEは、JSON編集の高度なサポートを提供しています。
- ブラウザ：Google ChromeやMozilla FirefoxなどのWebブラウザは、JSONファイルをドラッグ＆ドロップで開いて整形表示することができます。拡張機能（JSON Viewerなど）を使うとさらに見やすくなります。
- オンラインJSONビューアー：JSONFormatter.orgやjsonlint.comなどのWebサービスでは、JSONをブラウザ上で整形・検証することができます。
- コマンドラインツール：jqというコマンドラインツールは、JSONの解析・加工に非常に強力で、エンジニアの間で広く使われています。
JSONファイルをオンラインで変換する方法
JSONファイルを別のフォーマットに変換したい場合、あるいは他のフォーマットからJSONに変換したい場合、オンライン変換ツールを利用するのが手軽で便利です。Metric Converter（metric-converter.com）は、JSONをはじめさまざまなファイル形式に対応した無料のオンラインファイル変換サービスです。ソフトウェアのインストールが不要で、ブラウザからファイルをアップロードするだけで変換が完了します。JSONをCSVやXMLなどに変換する際にも活用できます。プライバシーに配慮した設計で、変換後のファイルは安全に処理されます。
よくある質問（FAQ）
JSONとXMLの違いは何ですか？
JSONとXMLはどちらもデータ交換フォーマットですが、いくつかの重要な違いがあります。JSONはより簡潔で読みやすく、JavaScriptとの親和性が高いのに対し、XMLはタグ構造により冗長になりやすいですが、属性や名前空間など表現力が高く、ドキュメント形式のデータに適しています。Webアプリケーションの新しいAPIではほとんどJSONが採用されていますが、エンタープライズシステムや設定が複雑なシステムではXMLも依然として使われています。
JSONファイルが壊れているか確認する方法はありますか？
JSONファイルの構文が正しいかどうかを確認するには、いくつかの方法があります。まず、jsonlint.comなどのオンラインJSONバリデーターにファイルの内容を貼り付けて検証する方法があります。また、コマンドラインではpython -m json.tool ファイル名.jsonを実行することで簡単に検証できます。Visual Studio Codeなどのエディタは、JSONファイルを開いた際に構文エラーを自動的に赤線でハイライトしてくれます。
JSONファイルにコメントを書くことはできますか？
標準のJSON仕様ではコメントはサポートされていません。JSONにコメントを含めるとパースエラーになります。ただし、この制限を回避するために、いくつかの拡張仕様が存在します。MicrosoftのJSONCはコメントと末尾カンマを許可した拡張仕様で、Visual Studio Codeの設定ファイルなどで使われています。また、"_comment"のような特別なキーに説明文を値として記述する慣例もありますが、これはデータとして扱われるため、正式なコメントとは異なります。
大きなJSONファイルを効率よく扱うにはどうすればよいですか？
数十MB以上の大きなJSONファイルを一度にメモリに読み込むと、パフォーマンスの問題が発生することがあります。このような場合、ストリーミングパーサーを使用することで、ファイル全体をメモリに展開せずに順次処理することができます。Pythonではijson、Node.jsではstream-jsonなどのライブラリが有効です。また、大量のデータを扱う場合は、JSONLinesフォーマット（各行に1つのJSONオブジェクトを記述するフォーマット）に変換することで、行単位の処理が可能になります。