JSONは厳格なルールを持つプレーンテキストであり、Notepad(メモ帳)で簡単に作成できます。多くの人が間違えるのはツールではなく構文です。正しい構造を理解していれば、ファイルの保存は簡単です。
Notepadで.JSONファイルを作成する方法
JSONファイルとは何ですか?
JSONとは「JavaScript Object Notation」の略です。波括弧内にキーと値のペアとしてデータを格納し、入れ子のオブジェクトや配列もサポートしています。軽量であり、主要なすべての言語で読み込めるため、アプリ、API、設定ファイルなどで広く使用されています。
基本的なJSONファイルは次のようになります:
{ "name": "John", "age": 28, "isActive": true, "skills": ["writing", "editing"]}ステップバイステップ:NotepadでJSONファイルを作成する
ステップ1:Notepadを開く
パソコンでNotepadを開くか、任意のブラウザから無料の オンラインメモ帳を使用してください。
ステップ2:開き括弧から始める
すべてのJSONファイルは、オブジェクトの場合は { で始まり、配列の場合は [ で始まります。ほとんどのファイルはオブジェクトから始まります。
ステップ3:キーと値を追加する
各キーを二重引用符で囲み、コロンを挟んでから値を記述します。各ペアはカンマで区切ります。
{ "title": "Sample File", "version": 1}ステップ4:ファイルを正しく閉じる
すべての開き括弧には対応する閉じ括弧を必ず記述してください。オブジェクトや配列の最後のキーと値のペアには、末尾のカンマを付けません。
ステップ5:.json拡張子で保存する
「ファイル」から「名前を付けて保存」を選択します。「ファイルの種類」のドロップダウンで「すべてのファイル」を選択します。ファイル名に data.json のように .json 拡張子を付けて保存します。このドロップダウンを変更せずに保存すると、JSONとして読み込めない .txt ファイルになってしまいます。
ステップ6:使用する前に検証する
スクリプトやアプリで使用する前に、ファイルを JSONエディタに貼り付けて、有効であることを確認してください。ここで事前に確認しておけば、後からのデバッグの手間を省くことができます。
覚えておくべきJSON構文のルール
二重引用符のみを使用する。 キーと文字列の値には、シングルクォーテーションではなくダブルクォーテーション(二重引用符)が必要です。
末尾のカンマは不要。 オブジェクトまたは配列の最後のアイテムの後には何も続きません。
コメントは使用できない。 標準のJSONファイル内では、
//や/* */のメモはサポートされていません。真偽値は小文字にする。
TrueやFALSEではなく、trueとfalseを使用します。数値に引用符は不要。 値がテキストである場合を除き、
"28"ではなく28と記述します。
よくあるエラーとその回避方法
問題: キーと値のペアの間のカンマが抜けている。 修正: 最後以外のすべてのペアの後には、カンマが必要です。
問題: 括弧の対応が間違っている。 修正: {} と [] のペアの数を数えて確認します。バリデータを使用すれば、一致していない正確な行を指摘してくれます。
問題: 文字列内の引用符がエスケープされていない。 修正: 内部の引用符はバックスラッシュでエスケープします(例:"He said \"hello\"")。
問題: キーに引用符がない。 修正: id や name などの簡単なキーであっても、すべてのキーを二重引用符で囲む必要があります。
まとめ
JSONファイルは、厳格な形式に従った単なるテキストです。キーと値を二重引用符で囲み、括弧の対応を合わせ、末尾のカンマを省き、.json拡張子で保存するだけです。使用する前にバリデータで一度実行して確認すれば、準備は完了です。