まずは、JSONの特徴や、JSONの登場前から使われてきたXML・CSVとの違いを紹介します。

JSON（ジェイソン）とは「JavaScript Object Notation」を称略した言葉であり、データ定義方法の一種です。名前の示すとおり、JavaScriptのオブジェクト表記方法をもとにしています。

JSONのデータ構造は、人にとってもコンピュータにとってもわかりやすくなっており、扱いやすいことが特徴の一つです。テキストベースのデータ形式で読み取りと書き込みが比較的容易に行なえます。

その扱いやすさから、JSONはJavaScript以外にもPythonやPHP、Javaなどさまざまなプログラミング言語で利用されています。

JSONが対応するデータ型は、以下の6種類です。

なお、文字列は日本語表記にも対応しています。

JSONが登場する以前は、データの定義方法としてXMLやCSVがよく利用されていました。

XMLは、HTMLの表記方法をもとにしたデータ定義言語です。タグを使用してデータを囲み階層構造を持たせられますが、テキスト量が多く内容が複雑なため、JSONに比べると理解しづらい傾向があります。

CSVはカンマでデータが区切られている形式で、その多くはExcelで表示されます。行と列の概念を持っていますが、データの階層構造を表現するのが難しく、複雑なデータを扱う場合には向いていません。

したがって、XMLやCSVと比べると、データのわかりやすさや扱いやすさではJSONが優れているといえるでしょう。

JSONを利用するメリットを4点紹介します。

多くのメリットがある一方で、JSONには構造上の弱点もあります。デメリットをあらかじめ把握しておくと、ほかのデータ形式と使い分ける判断がしやすくなるでしょう。ここでは、実務で影響しやすい3つのデメリットを紹介します。

JSONの仕様では、データ内にコメントを書くことが認められていません。プログラムのソースコードのように「この項目は何のための値か」という説明をファイル内に残せないため、項目数が多い設定ファイルなどでは、内容の意図が伝わりにくくなることがあります。補足が必要な場合は、仕様書など別のドキュメントに説明をまとめるのが一般的な対処法です。コメントを書ける拡張仕様としてJSON5やJSONCも存在しますが、標準のJSONとは互換性が異なるため、利用できる環境かどうかの確認が必要です。

JSONはオブジェクトや配列を何層でも入れ子にできるため、自由度が高い反面、階層が深くなりすぎてデータ全体の見通しが悪くなることがあります。階層の深いデータは読み解くのに時間がかかるだけでなく、プログラム側の処理も煩雑になりがちです。項目をあとから追加していくうちに、構造が肥大化するケースも少なくありません。データを設計する段階で、階層は必要最小限にとどめる、項目名の付け方を統一するといったルールを決めておくと、複雑化を防ぎやすくなるでしょう。

JSONで扱えるデータ型は、文字列・数値・bool値・null・オブジェクト・配列の6種類のみです。日付や時刻を表す専用の型は用意されていないため、日付は”2026-08-23″のような文字列として保存し、プログラム側で日付型に変換して使うのが一般的です。画像などのバイナリデータもそのままでは格納できず、Base64と呼ばれる方式でテキストに変換する必要があります。型の制限を理解しないままデータ設計を進めると、あとから変換処理の追加に手間がかかる点に注意しましょう。

JSONでは、{}の間に項目名と値を、コロンで区切って記述するのが基本です。

以下では、4つのルールに分けて解説します。なお、文字列が長く読みづらい場合は、改行やインデントを活用しても構いません。

JSONは、パソコンに標準搭載されているメモ帳などのテキストエディタがあれば、誰でもすぐにファイルとして作成できます。専用ソフトウェアの購入やインストールは不要です。ここでは、JSONファイルの作り方と開き方を手順に沿って紹介します。

JSONファイルは、テキストエディタで内容を記述し、拡張子を「.json」にして保存するだけで作成できます。手順は次のとおりです。
・メモ帳やVSCodeなどのテキストエディタを開く
・{“name”: “John”, “age”: 16}のように、JSONの書き方に沿ってデータを記述する
・「sample.json」のように、拡張子を.jsonにしてファイルを保存する
保存時の文字コードは、日本語の文字化けを防ぐためUTF-8を選択するのが基本です。エディタによっては保存画面で文字コードを指定できるため、必ず確認しておきましょう。

作成したJSONファイルは、テキストエディタの画面にドラッグアンドドロップするか、ファイルを右クリックして「プログラムから開く」でエディタを指定すると開けます。Google ChromeやMicrosoft Edgeといったブラウザにドラッグして、内容を表示することも可能です。ダブルクリックした際に意図しないアプリが起動してしまう場合は、拡張子「.json」に関連付けるアプリを、普段使うエディタへ変更しておくと扱いやすくなります。内容を編集したいときは、ブラウザではなくエディタで開きましょう。

ここでは、JSONの活用事例を紹介します。

主要なプログラミング言語には、JSONを読み書きするための機能が標準で用意されています。ここでは、実務でよく使われるJavaScript・Python・PHPの3言語について、JSON文字列とオブジェクトを相互変換する基本のコード例を紹介します。

JavaScriptには、JSONを扱う機能が標準で組み込まれています。JSON文字列からオブジェクトへの変換と、その逆の変換は次のように記述します。

サーバーへデータを送信する直前にJSON.stringifyで文字列化し、受け取った側がJSON.parseで復元するのが、Web開発における基本の流れです。

Pythonでは、標準ライブラリのjsonモジュールを読み込んで使います。JSON文字列と辞書型の相互変換は次のとおりです。

日本語を含むデータをjson.dumpsで変換すると、初期設定では文字が読めない形式に変換されます。ensure_ascii=Falseを指定すると、日本語のまま出力が可能です。ファイルを直接読み書きする場合は、json.loadとjson.dumpという別のメソッドを使う点も覚えておきましょう。

PHPでも、標準機能だけでJSONを扱えます。JSON文字列と連想配列の相互変換は次のとおりです。

json_decodeの2つ目の引数にtrueを指定すると連想配列として、省略するとオブジェクトとして受け取れます。日本語をそのまま出力したい場合は、json_encodeにJSON_UNESCAPED_UNICODEを指定しましょう。

JSONを利用する際の注意点としては、以下の3点が挙げられます。

JSONの構文はシンプルですが、記述ルールが厳密なため、わずかな入力ミスでもエラーが発生します。ここでは、実務で遭遇しやすい3つのエラーと解決法を紹介します。原因のパターンを知っておくと、修正にかかる時間を大幅に短縮できるでしょう。

最後の項目のうしろに余分なカンマが残っていると、構文エラーが発生します。{“name”: “John”, “age”: 16,}のように、最終項目のあとに付いたカンマが典型例です。JavaScriptのオブジェクトでは末尾のカンマが許容されるため、JavaScriptに慣れた方ほど見落としやすいミスといえます。エラーが出た場合は、まず各オブジェクトや配列の最後の項目にカンマが残っていないかを確認しましょう。項目の削除や並べ替えをした直後は特に発生しやすいため、編集後のチェックを習慣にするのが有効です。

項目名や文字列をシングルクォーテーションで囲んだり、引用符を付け忘れたりすると、読み込み時にエラーが発生します。{‘name’: ‘John’}は一見正しく見えますが、JSONで認められているのはダブルクォーテーションのみです。WordやWebページから文をコピーした際に、「“ ”」のような飾り付きの引用符が紛れ込んでエラーになるケースもあります。すべての項目名と文字列がダブルクォーテーションで囲まれているかを確認し、コピーで紛れ込んだ記号はエディタ上で打ち直しましょう。

日本語を含むJSONファイルで文字化けが起きる場合、文字コードの不一致が原因であることがほとんどです。JSONは原則としてUTF-8で保存する決まりのため、Shift-JISなど別の文字コードで保存すると、読み込み側で正しく表示されません。エディタの保存設定をUTF-8に変更することで解消できます。また、BOMと呼ばれる目印付きのUTF-8で保存すると、プログラムによっては読み込みエラーになるため、選択できる場合は「UTF-8（BOMなし）」を指定しておくと安全です。

JSONはテキストエディタだけでも編集できますが、専用ツールを活用すると、構文チェックや整形の手間を大幅に減らせます。ここでは、無料で使える定番のツールを3つ紹介します。前章で紹介したようなエラーの予防にも役立つでしょう。

日常的な開発ではVSCodeを基本とし、階層構造の確認にはJSON Editor Online、エラー原因の特定にはJSONLintという使い分けが便利です。いずれも無料で利用できるため、まずは手元のデータで試してみてはいかがでしょうか。

JSONは、扱いやすく便利なデータ定義方法の一つです。開発・メンテナンスのコスト削減やデータの自由度の高さ、さまざまなプログラミング言語での利用が可能な点など、多くのメリットがあります。

使用に際していくつかの注意点はあるものの、学習しやすく開発利用へのハードルも低いため、今後も多くの現場で利用されるでしょう。JSONの習得により、より効率的なデータ処理を実現してはいかがでしょうか。

株式会社PE-BANKは、1989年創業の35年以上の歴史を持つITフリーランスエージェントです。1,000社以上の取引先企業との連携によって常時5,000件以上の案件を公開しており、全国展開による地方案件の豊富さも強みとしています。 最大の特徴は、独自の「共同受注方式」によるマージン率の透明性と低さです。手数料は10%〜15%と業界トップクラスの低水準（高還元）であり、継続期間に応じてさらに優遇されるため、同一条件の案件でも「手取り額」が最大化されます。 所属エンジニアの平均年収は935万円に達しています。ITフリーランスとして、案件を探している方は、PE-BANKにご相談ください。