WebStorm 2026.1 Help

JSON

JSON(英語) 形式は、データの保存や構成ファイルの保存によく使用されます。 WebStorm は JSON ファイルの操作をサポートし、構文とフォーマットをチェックします —  一般的な構成ファイルでは、WebStorm がコードを検証し、 JSON スキーマに基づいてコード補完を提供します。このスキーマは、そのようなファイルの構造や内容を記述するための特別な形式です。

WebStorm には、最も一般的な形式の 登録済みスキーマセットが付属しています。 JSON Schema Store の スキーマカスタム JSON スキーマを使用することもできます。

スキーマストアからのスキーマとスキーマをバンドルする

JSON5 を有効にする

WebStorm は JSON5 を含む、最も人気のある JSON 標準のいくつかを認識します。 WebStorm は、デフォルトで json5 拡張子のファイルを JSON5 ファイルとして扱い、その中で新しい構文をサポートします。

JSON5 をデフォルトの拡張子 .json5 で使用する設定ファイル

JSON5 構文をすべての JSON ファイルに拡張する

  1. 設定 ダイアログ(Ctrl+Alt+S )で エディター | ファイルタイプ に移動します。

  2. 認識されたファイルタイプ リストで、 JSON5 を選択します。

  3. ファイル名のパターン 領域で、 追加 をクリックし、開く ワイルドカードの追加 ダイアログに *.json と入力します。

    JSON5 構文をすべての JSON ファイルに拡張する

JSON Schema Store のスキーマを使用する

WebStorm は、多くの人気のある構成ファイルのスキーマファイルをホストする JSON Schema Store からスキーマを自動でダウンロードして使用できます。 利用可能なスキーマ(例: tsconfig.json )のいずれかに名前が関連付けられているファイルを開いた瞬間に、WebStorm がこのスキーマをダウンロードし利用します。 適用されたスキーマの名前がステータスバーに表示されます。

JSON Schema Store からダウンロードした JSON スキーマ、適用されたスキーマの名前がステータスバーに表示されます

構成ファイルにカスタム名がある場合や、 スクラッチファイルで作業している場合は、ステータスバーの JSON スキーマなし をクリックし、リストから該当するスキーマを選択してください。 WebStorm は、現在のファイルを選択したスキーマに関連付け、このスキーママッピングを JSON スキーママッピング ページのリストに追加します。

または、 新規スキーママッピング をクリックして JSON スキーママッピング ページを開き、 新しいスキーマ関連付けを構成します

現在のファイルの JSON スキーマがありません

デフォルトでは、JSON Schema Store からのスキーマの自動ダウンロードが有効になっています。 オフになっている場合は、いつでも再度有効にすることができます。

JSON Schema Store からスキーマを自動的にダウンロードする

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | スキーマと DTD | リモート JSON スキーマ に移動します。

  2. リモートソースからの JSON スキーマのダウンロードを許可するschemastore.org の JSON スキーマカタログを使用する チェックボックスを選択します。

WebStorm には、一般的なスキーマがいくつか付属しています。 これらのスキーマは定期的に自動的に更新されますが、古くなっている可能性があります。

バンドルされているスキーマの最新バージョンを使用する

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | スキーマと DTD | リモート JSON スキーマ に移動します。

  2. 常に最新バージョンのスキーマをダウンロードする チェックボックスを選択します。

カスタム JSON スキーマを使用する

バンドルされている登録済みスキーマや JSON Schema Store のスキーマ以外にも、WebStorm で独自のスキーマを作成したり、他のストレージからカスタムスキーマを利用したりできます。 必要なスキーマを作成またはダウンロードしてプロジェクトのルートに保存するか、リソースの URL を指定して、WebStorm で自動的にスキーマをダウンロードできるようにします。

カスタムスキーマは、JSON スキーマ標準を満たす必要があります。 現在、WebStorm は 2020-12 以前のスキーマをサポートしています。

カスタムスキーマは 2020-12 標準に準拠しています

カスタム JSON スキーマ関連付けを作成する

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | スキーマと DTD | JSON スキーママッピング に移動します。

    または、ステータスバーの JSON スキーマなし をクリックしてから、 新規スキーママッピング を選択します。 この場合、WebStorm は自動的にファイルを 関連ファイル、フォルダー、パターンのリストに含めます。

  2. 以前に構成したすべてのスキーマが表示される中央のペインで、ツールバーの 追加 をクリックし、マッピングの名前を指定します。

  3. スキーマファイルまたは URL フィールドには、以前に作成またはダウンロードしたスキーマファイルの場所、または必要なスキーマが利用可能な URL を指定します。 スキーマファイルの名前または対応する URL アドレスは、 スキーマファイルまたは URL フィールドに表示されます。

    スキーマファイルを指定する
  4. スキーマが準拠する スキーマ仕様バージョン(英語)を指定します。

    スキーマバージョンを選択する
  5. このスキーマに対して検証するファイルまたはフォルダーのリストを作成します。 WebStorm はリストに基づいて、検証対象のファイルを内部で検出します。

    リストには、特定のファイル名、ディレクトリ全体の名前、ファイル名のパターンを含めることができます。 ファイル名のパターンを指定するには、次の規則を使用します。

    • role-* は、 role- で始まる名前を持つすべてのファイルと一致します。

    • role-*/**/*.yaml は、 role// を含む名前を持つすべての .yaml ファイルと一致します。

    • role-**.yaml は、 role- で始まる名前を持つすべての .yaml ファイルと一致します。

    リストに項目を追加するには、 マッピングを追加 をクリックします。

    スコープにアイテムを追加する

    ファイルまたはフォルダーへのパスを指定するか、ファイルパターンを入力します。 プロジェクトルートを基準とした相対パスを指定します。

    ファイルパターンを指定

リモートソースからの JSON スキーマの自動ダウンロードを有効にする

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | スキーマと DTD | リモート JSON スキーマ に移動します。

  2. リモートソースからの JSON スキーマのダウンロードを許可する を選択します。

    チェックボックスをオフにすると、JSON Schema Store のスキーマを含む JSON スキーマに関するネットワークアクティビティが無効になります。

JSON スキーマを無効にする

  • ファイルのスキーマを無効にするには、ステータスバーの JSON スキーマ ウィジェットをクリックし、ポップアップリストから ファイルの JSON スキーマを無視 を選択します。

    現在のファイルのスキーマを無視する

    または、 スキーママッピングの編集 を選択して スキーマのスコープを編集します。 例: ファイル名が明示的に指定されている場合は、適切なパターンを編集したり、リストからファイルを削除したりできます。

    最後に、 新規スキーママッピング を選択し、 上記のようにスキーマの関連付けを構成できます。

    スキーマを無視して新しいマッピングを作成する
  • 現在のファイルのスキーマとの関連付けを復元するには、ステータスバーの JSON スキーマなし をクリックし、ポップアップリストから ファイルの JSON スキーマの無視を停止 を選択します。

    ファイルのスキーマとの関連付けを復元する
  • 現在のプロジェクト全体に対してカスタムスキーマを無効にするには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 言語 & フレームワーク | スキーマと DTD | JSON スキーママッピング に移動して、中央のペインでスキーマ関連付けを選択し、ツールバーの 削除ボタン をクリックします。

スキーマのスコープ間の競合を処理する

ファイル、フォルダー、パターンが 2 つ以上のスキーマのスコープに属している場合、WebStorm はこの競合を検出し、エディターおよび 設定 ダイアログの JSON スキーママッピング ページに警告を表示します。

エディターでは、複数のスコープに属するファイルを開くと警告が表示されます。

エディターで競合するスキーマスコープに関する通知

設定 ダイアログの JSON スキーママッピング ページでは、複数のマッピングのスコープが重複している場合に警告が表示されます。

設定における競合するスキーマスコープに関する通知ダイアログ

JSON スキーマで HTML 記述を使用する

デフォルトで、WebStorm はドキュメントポップアップで JSON スキーマ定義のドキュメントを表示する際に HTML 文字をエスケープします。

スキーマが description プロパティを使用するとします。

{ "id": "http://some.site.somewhere/entry-schema#", "$schema": "https://json-schema.org/draft/2020-12/json-schema-core", "type": "object", "required": [ "options" ], "properties": { "options": { "type": "array", "description": "Interesting details: Fresh New Awesome", "minItems": 1, "items": { "type": "string" }, "uniqueItems": true }, "readonly": { "type": "boolean" } } }

すると、 クイックドキュメント ポップアップは次のようになります。

description プロパティを持つ JSON スキーマ定義のドキュメントのフォーマットがありません

豊富な HTML マークアップを使用した見栄えの良いドキュメントを作成するには、HTML の説明を description ではなく x-intellij-html-description 拡張プロパティに保存します。

{ "id": "http://some.site.somewhere/entry-schema#", "$schema": "https://json-schema.org/draft/2020-12/json-schema-core", "type": "object", "required": [ "options" ], "properties": { "options": { "type": "array", "x-intellij-html-description": "<p><b>Interesting</b> <i>details:</i></p>\n <ul><li>Fresh</li><li>New</li><li>Awesome</li></ul>\n <div style='background-color: #fff77c'>Choose schema with HTML description =)</div>", "minItems": 1, "items": { "type": "string" }, "uniqueItems": true }, "readonly": { "type": "boolean" } } }

クイックドキュメント ポップアップは次のようになります。

x-intellij-html-description プロパティを使用した JSON スキーマ定義のドキュメントの HTML 記述

構文ハイライトを構成する

好みや習慣に合わせて JSON 対応の構文ハイライトを設定できます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で エディター | カラースキーム | JSON に移動します。

  2. カラースキームを選択し、デフォルトから継承されたハイライト設定をそのまま使用するか、 カラースキーム:エディターのフォントと色彩 の説明に従ってカスタマイズしてください。

2026 年 6 月 8 日