qktools

JSON 入門チュートリアル:文法、構造、よくあるミス

公開日 2026-06-06

JSONは現在最も人気のあるデータ交換フォーマットで、ほぼすべてのWebインターフェースや設定ファイルで使用されています。簡潔で読みやすく、言語を越えて利用できます。本チュートリアルでは、JSONの文法规則やよくある落とし穴をゼロから学び、素早くJSONを正しく理解し記述できるようサポートします。

JSONとは

JSONはJavaScript Object Notationの略で、軽量级のテキストデータ形式です。人間が読める形式で構造化データを記述し、ほとんどのプログラミング言語でネイティブサポートされています。フロントエンド、バックエンド、サービス間でデータを伝送するための共通言語です。

基本データ型

JSONは6つの値をサポートしています:文字列(二重引用符で囲む)、数値、ブール値(true / false)、null、オブジェクト(波括弧)と配列(角括弧)。

注意:文字列には二重引用符を使用し、単一引用符は使用できません。数値には引用符を付けません。これらは初心者が最も混乱しやすい点です。

オブジェクトと配列

オブジェクトは「キーと値のペア」の集合で、波括弧で囲み、キーは二重引用符付きの文字列でなければなりません。例えば {"name": "小明", "age": 18}。配列は「順序付き値リスト」で、角括弧で囲みます。例えば [1, 2, 3]。

オブジェクトと配列は任意にネストでき、複雑な階層構造を表現できます。例えば、ユーザー オブジェクトにアドレス オブジェクトとタグ配列が含まれる場合です。

最も一般的なフォーマットエラー

初心者がよく陥る落とし穴は、最後の要素の後にカンマがある(トレーリングカンマ)、単一引用符を使用した、キー名に引用符がない、括弧や引用符が一致しない、そしてJSONにコメントを記入した(標準JSONはコメントをサポートしていない)ことです。

これらのエラーはすべて解析失敗を引き起こします。エラーが発生した場合は、まずメッセージに従って行番号を特定し、上記の問題点を重点的にチェックしてください。

ツールを使用した検証とフォーマット

実際の開発では、乱れたJSONをインデント付きのフォーマットに整形すると、読みやすさとデバッグが大幅に向上します。qktoolsのJSONフォーマットツールを使用すると、ワンクリックでJSONを整形、圧縮、検証でき、エラーの原因を正確に表示します。

JSONを表に変換する必要がある場合は、JSONからCSVへの変換ツールを使用すると、表計算ソフトで簡単に閲覧・処理できます。

関連ツール