PhpStorm 2026.3 Help

YAML

PhpStorm を使用すると、YAML ファイル( .yml 、 .yaml )を操作でき、次の機能がサポートされます。

エディターで利用可能な YAML 固有の機能をいくつか見てみましょう。

アンカーとエイリアス

PhpStorm は、アンカーとエイリアスの使用をサポートしています。 YAML ファイルで新しいアンカーを指定すると、エディターはこのアンカーがどのノードでも使用されていないという警告を表示します。

YAML: 未使用のアンカー警告

エディターを使用すると、このアンカーのエイリアスを 完成させることができます。

YAML: 完全なエイリアス

アンカーの使用箇所をすばやく見つけるには、アンカー上にキャレットを置き、 Ctrl+B を押します。

YAML: エイリアスに移動する

PhpStorm は、アンカーとエイリアスに対する 名前変更リファクタリング をサポートしています: アンカーにキャレットを置き、 Shift+F6 を押します。 または、アンカーを右クリックして リファクタリング | 名前の変更 を選択します。

renaming the YAML anchor

JSON スキーマ

PhpStorm は、JSON スキーマを使用する YAML ファイルのコード補完およびインスペクションをサポートします。 PhpStorm は、ファイルの場所または構造に基づいてスキーマを自動的に推測することも、 手動で選択することもできます。 例: .github/workflows ディレクトリに GitHub アクションワークフローファイルがある場合、PhpStorm は、 schemastore.org(英語) から自動的に読み込まれた github-workflow.json スキーマに基づいてオプションを完了することを提案します。

YAML: スキーマに基づいて完成

設定 ダイアログ (Ctrl+Alt+S) の 言語 & フレームワーク | スキーマと DTD | リモート JSON スキーマ ページを使用して、JSON スキーマのロードを管理できます。

必要に応じて、 言語 & フレームワーク | スキーマと DTD | JSON スキーママッピング で必要なスキーマファイルへのパスを指定できます。

ファイルの JSON スキーマを選択する

特定のファイルにカスタムスキーマを指定できます。

  1. ステータスバーのスキーマスイッチャーをクリックします。

    ファイルのスキーマを選択する
  2. 表示されたリストで、提案されたスキーマのいずれかを選択するか、 新規スキーママッピング… をクリックします。 これにより、ファイルのローカルスキーマまたはリモートスキーマを指定できる JSON スキーママッピング 設定が開きます。

スキーマからプロパティを取得する

IntelliJ IDEA が YAML ファイルのスキーマを検出した場合は、専用のアクションを使用してすべてのプロパティをそのファイルにすばやく挿入できるため、手動で入力する必要がなくなります。

  • スキーマに必須のプロパティが含まれており、これらの特定のプロパティのみを挿入したい場合は、ファイル内の任意の場所で Alt+Enter (コンテキストアクションの表示) を押し、 欠落しているプロパティの追加 を選択します。

  • スキーマで使用可能なすべてのプロパティを挿入する場合は、ファイル内の任意の場所で Alt+Enter (コンテキストアクションの表示) を押し、 JSON スキーマからすべてのプロパティを入力 を選択します。

$schema キーワードを使用する

ファイル自体内でスキーマを参照することもできます。

  1. ファイルの先頭に # $schema: と入力します。

  2. スキーマファイルの名前の入力を開始します。 schemastore.org から読み込まれたスキーマ名の補完を利用できます。

    ローカルスキーマファイルを使用する場合は、スキーマを使用するファイルに対する相対パスを指定します (例: # $schema: ./my-schema.json)。 これにより、インスペクション、補完、プロパティ入力アクションなど、リモートスキーマを使用する場合と同じコーディング支援が可能になります。

    Completion from local schema

キーのコピー

PhpStorm は、YAML ファイルで指定された特定のオプションへのフルパスをコピーする機能を提供します。 これは 2 つの方法で実行できます。

  • 必要なキーにキャレットを置き、 Ctrl+Alt+Shift+C を押します。

  • 必要なキーにカーソルを合わせ、右クリックして 参照のコピー を選択します。

YAML: 参照をコピー

例: 上のイメージでは、 default.server.port がコピーされます。

入力ハンドラー

YAML ファイルを編集するとき、PhpStorm はインデント、シーケンスマーカー、角括弧、引用符を維持します。 次の例では、 <caret> がキャレット位置を示します。

シーケンスマーカー

シーケンス項目の後で Enter を押すと、PhpStorm は新しい項目を開始し、 - マーカーを自動的に挿入します:

services: - nginx<caret>
services: - nginx - <caret>

空の項目で Enter をもう一度押すと、PhpStorm はマーカーを削除し、ネストされたシーケンス内も含めて、キャレットを親のインデントレベルに移動します。

シーケンス項目にマッピングが含まれている場合、 Enter を押すと、マーカー挿入がオンの場合でも、別のマーカーを追加せずに、新しくインデントされた行でマッピングを継続します:

services: - name: web<caret> - name: db
services: - name: web <caret> - name: db

空の項目を削除するには、 - マーカーに続くスペースの後で Backspace を押します。 PhpStorm は、 - とそれに続くスペースを単一のアクションで削除します。 値が同じ行でマーカーの後に続く場合でも、PhpStorm はスペースとともにマーカーを削除し、値をその位置に保持します:

services: - <caret>nginx
services: <caret>nginx

インデント

Enter を押すと、PhpStorm は現在の構造に一致するインデントレベルで新しい行を維持します:

  • 値のないキーの後では、新しい行は一段階深くインデントされます。

  • キーと値のペアの後では、新しい行は同じレベルのままです。

  • ブロックスカラーインジケーター (|) の後では、新しい行は一段階深くインデントされ、以降の行はそのレベルのままです。

database:<caret>
database: <caret>

ブロックスカラー内では、新しい行はキーの一段階下にある標準のブロックインデントに配置されます。 現在の行が手動で過剰にインデントされている場合でも、新しい行は過剰にインデントされたテキストに揃えるのではなく、標準のブロックインデントを使用します。

完了したエントリの下にある空白のみを含む行で Enter を押すと、PhpStorm は新しい行を再整列するのではなく、手動で設定したインデントを保持します。

まだ項目のないシーケンス内の空行で - の後にスペースを入力すると、PhpStorm はマーカーのインデントを修正します。 インデントシーケンス値 オプションがオンの場合、マーカーは親キーより一段階深く配置されます; オフの場合、マーカーは親キーに揃えられます。 シーケンスにすでに項目が含まれている場合、マーカーは現在のインデントを保持します。 このオプションは、 設定 ダイアログ (Ctrl+Alt+S) の エディター | コードスタイル | YAML ページにあります。

角括弧と引用符

キーまたは値の位置では、PhpStorm はフローコレクションと引用符付きスカラーを自動的に閉じます。 [、 {、 " 、または ' を入力すると、PhpStorm は対応する文字を挿入し、キャレットをペアの間に配置します:

ports: <caret>
ports: [<caret>]

自動クローズは、新しいキーや値の位置、既存のフローコレクション内の位置など、文字が YAML 構造トークンを開始する場所にのみ適用されます。 キャレットがプレーンスカラーテキスト内またはその直後にある場合、PhpStorm は文字を通常のテキストとして挿入し、何も閉じません。

閉じる ]、 } 、または引用符を同じ文字の直前で入力すると、PhpStorm は重複を挿入する代わりに、その文字を越えてキャレットを移動します。 ただし、次の文字がペアになっていない引用符の場合、同じ引用符文字を入力すると、既存のものを越えて移動するのではなく、新しいペアが作成されます。

空のペアを削除するには、ペアの文字の間で Backspace を押すと、PhpStorm が両方を削除します。

キーと項目の移動

キー、ネストされたブロック、またはシーケンス項目を移動するには、キャレットをその上に置き、 Ctrl+Shift+Up または Ctrl+Shift+Down を押します。 PhpStorm は、ネストされた内容を含むエントリ全体を移動し、インデントを正しく保ちます:

services: web<caret>: image: nginx db: image: postgres
services: db: image: postgres web<caret>: image: nginx

複数のエントリを選択すると、PhpStorm は選択範囲をエントリ全体に拡張し、グループとして移動します。

貼り付け中

YAML ファイルに内容を貼り付けると、PhpStorm はそれをターゲット構造に合わせて調整します:

  • シーケンスに貼り付けられたプレーンな行は、それぞれ独自の - マーカーを持つ個別の項目になります。

  • 貼り付けた行が - で始まる場合、または接頭辞付きの行と接頭辞なしの行が混在している場合、PhpStorm は各行にマーカーがちょうど一つ含まれるように正規化します。

  • spring.datasource.url などのドット区切りパスは、ネストされたキーに展開されます。

  • 複数行ブロックは、最初の行がキャレットのインデントに一致するように再インデントされ、内部の行は相対的なインデントを保持します。 空行は空のままです。

  • 既存のキーの直前に貼り付けると、PhpStorm は貼り付けられたブロックを再インデントし、既存のキーを元の列に保ちます。

たとえば、 spring.datasource.url をマッピング位置に貼り付けます:

config: <caret>
config: spring: datasource: url:<caret>

ドット区切りキーの展開をオンまたはオフにするには、 設定 ダイアログ (Ctrl+Alt+S) の エディター | 一般 | スマートキー | YAML ページで 貼り付け時にキーシーケンスを自動展開する オプションを使用します。

2026 年 11 月 9 日