ファイルを知る、使いこなす。

.json

JSONデータ

Web・開発

JSONはオブジェクトや配列を表すデータ形式です。標準JSONではキーと文字列に二重引用符を使い、コメントや末尾カンマを使いません。見た目が似たJSONCとは受け付ける構文が違います。

主な用途: アプリ設定・API・データ交換
中身の種類: テキスト

目次・よくある質問・根拠資料を見る

内容の最終確認：2026-10-12 · 編集：Kai

開き方・操作手順

使っている環境や目的の項目を開いて、手順を確認してください。

エディター：構造を確認

保存前に元ファイルのコピーを作ります。

VS Code等でファイルを開き、対応する言語モードを確認します。
オブジェクトのキー、配列、文字列、数値を区別し、括弧とカンマを確認します。
読み込み文字コードと元の改行形式を確認し、リッチテキストとして保存しないようにします。

構文確認：JSONとして検証

JSONとコメント付きJSONを区別します。

対応エディターの診断やJSONパーサーでコピーを読み込みます。
エラー位置の前後で、二重引用符、余分なカンマ、コメントを確認します。
修正後に再検証し、整形しても値が変わっていないか比較します。

アプリ：データとして読み込む

構文が正しいだけではアプリ用データになりません。

アプリの指定スキーマや必要キーを確認します。
コピーをテスト環境で読み込み、型や必須項目のエラーを確認します。
件数と重要なID・日付・空値を確認してから本来の用途へ使います。

操作名・対応状況はアプリ・OS・版によって異なります。変更する前に原本を残してください。

開けないとき：症状から確認

構文エラー：末尾カンマ、単引用符、コメント、引用符内の改行やエスケープを確認します。
値は読めるのにアプリが拒否：必要なキー、データ型、アプリ固有の仕様を確認します。構文が正しいことと有効な設定は別です。
日本語が文字化け：交換用JSONはUTF-8を基本に確認します。再保存前に元の文字コードを確認します。
末尾のカンマで失敗：厳密なJSONは余分なカンマやコメントを許可しません。JSONCの設定と区別します。
IDの桁が変わる：大きな整数をアプリが正確に保持できるか確認し、仕様に従って文字列で扱います。
構文は通るのに拒否される：必要キー、型、許容値をスキーマと照合します。

JSON → CSV / 整形したJSON

CSVにする配列と列を決め、入れ子の値をどの列へ出すか確認します。
対応ツールで別出力し、行数、先頭の0、日付、欠損値を元データと比較します。
変換前後のキー、件数、文字列・数値・日付などの型を照合し、変換できない項目は別に記録します。

CSVでは入れ子や型をそのまま保持できない場合があります。元JSONを残します。

JSONの最小例と値の型

キーと文字列は二重引用符を使います。文字列の数字と数値、nullと空文字は違う値です。

整形は読みやすさのための操作で、必要キーや値の正しさを保証しません。

{"name":"example","count":2,"enabled":true,"items":["a","b"]}

この手順の根拠：Microsoft · Editing JSON with Visual Studio Code / Python Software Foundation · json — JSON encoder and decoder

CSV化で失われる階層を確認

入れ子のオブジェクトや配列は単純な表と同じではありません。配列の展開で行数が増えるか、別表にするか決めます。

元JSONを残し、ID、空値、改行を含む文字列が出力先で同じ意味になるか確認します。

この手順の根拠：Microsoft · Editing JSON with Visual Studio Code / Python Software Foundation · json — JSON encoder and decoder

関連形式との違い
形式	主な役割	選ぶときの注意
JSON	階層データ	キーと型を検証
CSV	平面の表	階層の展開条件が必要
JSONC	コメント対応の設定等	厳密JSONと区別

取り扱いと安全性

設定にはAPIキーやトークンが入る場合があります。Webの整形サービスへ貼り付ける前に秘密情報を確認し、取り込むアプリの動作も確認します。

よくある質問

JSONにコメントを書ける？

標準JSONでは不可です。アプリ独自のJSONC対応とは区別します。

数字を引用符で囲んでも同じ？

文字列になり、数値とは型が違います。

整形すれば壊れたデータを修復できる？

整形は内容の正しさを保証しません。構文とアプリの仕様を確認します。

JSONはExcelでそのまま表になる？

階層や配列をどの列・行へ展開するか決めます。読み込み機能と結果の件数を確認します。

同じキーを二回書いてよい？

読み取り結果が実装によって異なるため避けます。重複を検出して意図した値に整理します。

形式の基本情報：正式名称・MIME type・管理団体

名称: JavaScript Object Notation
管理・仕様: IETF (RFC 8259)
MIME type: application/json

公式・一次情報

標準仕様RFC 8259 — JSON
JSONの値・文字列・構文と相互運用上の注意を定義しています。
IETF / RFC Editor · リンク確認：2026-10-08
ソフトウェア公式Editing JSON with Visual Studio Code
JSONの構文チェック・整形とJSONCとの違いの資料です。
Microsoft · リンク確認：2026-10-12
プロジェクト公式json — JSON encoder and decoder
JSONの型、解析、数値や重複キーに関する注意です。
Python Software Foundation · リンク確認：2026-10-12