JSONとは？プログラミングでの書き方や基本ルールを徹底解説

結論： JSON（JavaScript Object Notation）とは、プログラミング言語やOSの壁を越えてデータをやり取りするための、世界標準のテキストフォーマットです。

JSONは「プログラミング言語」ではない

最初に誤解を解いておきます。「JSONプログラミング」という言葉で検索されることが多いですが、JSON自体はプログラミング言語ではありません。

JSONはデータ記述言語、つまり「データの書き方のルールブック」です。Pythonで書かれたプログラムと、Javaで動いているシステムが会話をする際、お互いの言葉（文法）は異なりますが、「JSON」という共通のルールでデータを渡すことで、スムーズな意思疎通が可能になります。

現代のWeb開発において、JSONを扱えないことは「読み書きができない」のと同義です。この記事では、JSONの正確な構文ルールから、現場で頻発するエラー、そして主要言語（JavaScript/Python）での具体的な扱い方までを網羅的に解説します。

【ここでのポイント】JSONはプログラミング言語ではなく、データを保存・交換するための「形式（フォーマット）」です。ロジックは持てませんが、あらゆる言語で読み書きできる汎用性が武器です。

JSONとは？「共通申請書」としての役割

JSON（ジェイソン）は、元々JavaScriptのオブジェクト表記法をベースに考案されましたが、現在は特定の言語に依存しない独立した規格（Language Independent）として確立されています（RFC 8259 / ECMA-404）。

JSONの役割を直感的に理解するために、「Web上の『共通申請書』フォーマット」とイメージしてください。

例えば、役所の手続きを想像してみましょう。

二人が直接会話をしても通じませんが、「この申請書（JSON）の『名前』欄には名前を書き、『年齢』欄には数字を書く」という共通のフォーマットが決まっていれば、お互いに書かれた内容を正しく理解し、処理を進めることができます。

なぜJSONが標準なのか？XML・CSVとの構造比較

データの保存形式には、他にもCSVやXMLがあります。なぜそれらを押しのけてJSONが主流になったのでしょうか。理由は「構造化能力」と「軽量さ」のバランスが圧倒的に良いからです。

RPGゲームの武器データ「エクスカリバー（攻撃力50）」を例に、3つの形式を比較してみましょう。

1. CSV (Comma-Separated Values)

101,Excalibur,50

2. XML (Extensible Markup Language)

<item>
  <id>101</id>
  <name>Excalibur</name>
  <attack>50</attack>
</item>

3. JSON

{
  "id": 101,
  "name": "Excalibur",
  "attack": 50
}

JSONの基本構文：5つの記号と書き方の鉄則

JSONの構文は極めてシンプルです。基本的に以下の5種類の記号とダブルクォーテーションだけで構成されます。

書き方の3大鉄則

ここだけは絶対に覚えてください。JSONを手書きする際のミスの大半はここから生まれます。

【ここでのポイント】JSONは構文ルールが非常に厳格です。JavaScriptの感覚で「多少省略しても動くだろう」と思っていると、必ずパースエラー（SyntaxError）になります。「すべてダブルクォートで囲む」と覚えておけば間違いありません。

JSONで使用可能な6つのデータ型と制約

JSONの「値（Value）」としてセットできるデータ型は、以下の6種類に限定されています。

データ型	書き方の例	解説
文字列	"text", "こんにちは"	必ず " で囲む。改行などはエスケープ文字（\n）を使う。
数値	123, 10.5, -50	" で囲まない。整数と浮動小数点の区別はない。8進数や16進数表記は不可。
真偽値	true, false	" で囲まない。全て小文字であること（Trueは不可）。
null	null	値が空であることを示す。" で囲まない。全て小文字。
オブジェクト	{ "k": "v" }	キーと値の集合。
配列	[ 1, 2, 3 ]	値の順序付きリスト。

注意：JSONで使えない型

JavaScript等では当たり前に使う以下の型は、JSONには存在しません。

階層構造の表現：オブジェクトと配列の組み合わせ

JSONの真価は「ネスト（入れ子）」にあります。
オブジェクトの中に配列を入れたり、配列の中にオブジェクトを入れることで、実世界の複雑なデータをそのまま表現できます。

ここでは「RPGゲームのセーブデータ」を例に、JSONの構造設計を見てみましょう。

{
  "save_id": "slot_01",
  "player": {
    "name": "Hero",
    "level": 45,
    "stats": { 
      "str": 80, 
      "int": 30 
    }
  },
  "inventory": [
    "Potion", 
    "Elixir", 
    "Tent"
  ],
  "party_members": [
    { "name": "Mage", "hp": 120 },
    { "name": "Priest", "hp": 150 }
  ],
  "is_poisoned": false,
  "play_time_sec": 36000
}

構造のポイント

【ここでのポイント】「名前がついているものはオブジェクト」「順序よく並んでいるものは配列」。この2つの原則さえ押さえておけば、どんなに複雑なデータ構造もJSONで表現できます。

エラー原因の9割！初心者がやりがちな「NG構文」リスト

エディタやAPI通信で SyntaxError: Unexpected token... と怒られたら、十中八九以下のどれかに該当します。

1. 末尾のカンマ (Trailing Comma)

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

3. キーのクォート忘れ

4. コメントの記述

5. 数値のゼロ埋め

実践：プログラミング言語での読み書き（JavaScript編）

Webフロントエンド開発では、サーバーから受け取ったJSON文字列をJavaScriptのオブジェクトに変換して画面に表示する処理が日常的に行われます。

デシリアライズ（文字列 → オブジェクト）

JSON形式の文字列を、プログラムで扱えるオブジェクトに変換することを「デシリアライズ（パース）」と呼びます。

const jsonString = '{"name": "Hero", "level": 45}';

try {
  // 文字列をオブジェクトに変換
  const user = JSON.parse(jsonString);
  console.log(user.name); // 出力: Hero
} catch (e) {
  // JSONの形式が間違っているとエラーになるため、try...catch推奨
  console.error("JSONの形式が不正です", e);
}

シリアライズ（オブジェクト → 文字列）

逆に、データをサーバーに送信したり保存したりするために、文字列へ変換することを「シリアライズ」と呼びます。

const data = {
  name: "Hero",
  items: ["Sword", "Shield"]
};

// オブジェクトをJSON文字列に変換
// 第3引数の「2」はインデントのスペース数（見やすく整形される）
const jsonOutput = JSON.stringify(data, null, 2);
console.log(jsonOutput);

【ここでのポイント】JSON.parse() で読み込み、JSON.stringify() で書き出し。この2つのメソッドはWeb開発の基本中の基本です。特に stringify の第3引数でインデントを付けられる小技は、デバッグ時に役立ちます。

実践：プログラミング言語での読み書き（Python編）

Pythonでは標準ライブラリの json モジュールを使用します。Pythonの辞書型（dict）やリスト型（list）とJSONは非常に相性が良いです。

基本操作

import json

# JSON文字列
json_str = '{"name": "Hero", "is_alive": true, "items": null}'

# デシリアライズ（文字列 → 辞書）
data = json.loads(json_str)

print(data["name"])      # Hero
print(data["is_alive"])  # True （Pythonのブール値に自動変換）
print(data["items"])     # None （nullはNoneに変換）

日本語を含むデータの書き出し

日本国内の開発でよくハマるのが、日本語が \uXXXX のようなUnicodeエスケープシーケンスになってしまう問題です。

rpg_data = {
    "id": 101,
    "name": "エクスカリバー",
    "attack": 50
}

# ensure_ascii=False を指定しないと日本語が文字化け（エスケープ）して見える
json_output = json.dumps(rpg_data, ensure_ascii=False, indent=2)

print(json_output)

ファイルの読み書き

ファイル操作の場合は、関数名から s を抜いた load と dump を使います。

Web開発におけるJSONの役割とエコシステム

JSONは単なるデータ交換フォーマットを超え、現在ではシステムの中核を担う存在になっています。

開発効率を上げるエディタと検証ツール

JSONは人間が読めるとはいえ、カッコの対応関係などを手書きで管理するのはミスのもとです。ツールによる支援を積極的に受けましょう。

1. Visual Studio Code (VSCode)

拡張子を .json にするだけで、標準機能が働きます。

2. JSONLint

Webブラウザ上で使える構文チェッカー（バリデータ）です。APIから返ってきた謎の文字列をコピペして「Validate JSON」を押せば、どこが間違っているかを特定し、きれいに整形してくれます。

3. ブラウザ拡張機能

ChromeやEdgeに「JSON Viewer」系の拡張機能を入れておくと、ブラウザでAPIのURLを叩いた際、生のテキストではなく構造化されたツリー形式で見やすく表示されます。API開発をするなら必須のツールです。

よくある質問

JSONデータにコメントを書く裏技はありますか？

原則ありません。
どうしても必要な場合は、データとして "_comment": "ここにメモ" というキーを追加する運用回避策がありますが、システムによっては無視されたり、予期せぬエラーの原因になる可能性があるため推奨されません。コメントが必須な設定ファイル用途であれば、JSONC（JSON with Comments）やYAMLの採用を検討してください。

日付データはどう扱うのが正解ですか？

ISO 8601形式の文字列として扱います。
"2026-05-20T10:00:00Z" のような文字列として格納するのが世界標準です。受け取り側のプログラムで、この文字列を日付オブジェクトにパースして使用します。Unixタイムスタンプ（1716199200のような数値）を使う場合もありますが、人間が読めないためデバッグしづらくなります。

キーの順番は保存されますか？

保証されません。
JSONの仕様上、オブジェクト内のキーの順序は「順不同」です。{"a":1, "b":2} と {"b":2, "a":1} は同じデータとして扱われます。もしデータの並び順に意味を持たせたい場合は、オブジェクトではなく「配列」を使用する必要があります。

---

まとめ

JSONは、現代のITエンジニアにとって「読み書きできて当たり前の共通言語」です。

API連携や設定ファイル、データベースなど、開発のあらゆる場面でJSONは登場します。