WebStorm 2025.2 ヘルプ

プロジェクト構造の設定

WebStorm では、コンテンツは現在作業しているファイルのコレクションであり、サブフォルダーの階層に編成されている可能性があります。プロジェクトの最上位フォルダーは、そのコンテンツルートです。

プロジェクトの一部として任意のフォルダーを追加できます。これを行うには、複数のコンテンツルートで作業するに従って、このフォルダーをディレクトリページの新しいコンテンツルートとして追加します。

コンテンツルートのフォルダーの設定

コンテンツルート内で、WebStorm は、編集したソースコードを含むフォルダーと、他の種類のコンテンツを含むフォルダーを区別できます。デフォルトでは、すべてのフォルダーはソースとして扱われ、別のタイプとしてマークしない限り、Source folder で示されます。

  • テスト Tests folder フォルダーを使用すると、テストに関連するコードを実稼働コードとは別に保持できます。

  • リソースルート Resources root フォルダー: リソースルートフォルダー内のファイルは、フルパスを指定する代わりに、これらのフォルダーを基準にして参照できます。例: HTML img タグの src 属性内で入力を開始すると、自動補完によってリソースルートフォルダーからのイメージが提案されます。

  • 除外された Excluded フォルダーは、コード補完、ナビゲーション、インスペクションによって無視されます。現時点では不要なフォルダーと特定のファイルを除外します。これにより、WebStorm のパフォーマンスを向上させることができます。

フォルダーのカテゴリを構成するには

  • プロジェクトツールウィンドウのフォルダーを右クリックし、コンテキストメニューからディレクトリをマークを選択し、必要なカテゴリを選択します。

    Choosing the folder category
  • あるいは、設定ダイアログ (Ctrl+Alt+S) を開いてディレクトリに移動し、フォルダーのカテゴリを構成します。

以前のカテゴリのフォルダーを復元するには

  • プロジェクトツールウィンドウでフォルダーを右クリックし、コンテキストメニューからディレクトリをマークを選択してから <現在のカテゴリ> としてマークを解除するを選択します。除外フォルダーの場合は、除外のキャンセルを選択します。

ファイルを除外する

今すぐファイルを必要としないが完全に削除したくない場合は、一時的にプロジェクトからファイルを除外することができます。コード補完、ナビゲーション、インスペクションでは、除外されたファイルは無視されます。

  • ファイルを除外するには、プロジェクトツールウィンドウでファイルを右クリックし、メニューからファイルタイプのオーバーライドを選択します。

    Exclude a file from project: override file type

    ファイルタイプの選択リストから、プレーンテキストを選択します。

    Exclude a file from project: select file type

    ファイルは、ディレクトリツリーで Plain Text アイコンでマークされています。

  • 変更を元に戻すには、ファイルを右クリックし、メニューからファイルタイプのオーバーライドを元に戻すを選択します。

    Revert file type override

名前パターンによるファイルとフォルダーの除外

  1. 設定ダイアログ(Ctrl+Alt+S)で、ディレクトリに移動します。

  2. 除外ファイルフィールドに、除外するファイルとフォルダーの名前を定義するマスクを入力します(例: *.min.js または lib)。区切り文字としてセミコロンを使用します。

    • ファイルの名前がこれらのパターンのいずれかに一致する場合、ファイルは除外されたものとして扱われます。

    • フォルダーの名前がパターンに一致する場合、このフォルダーとそのサブフォルダー内のすべてのファイルが除外されます。

    名前パターンで除外されたフォルダーは、プロジェクトツールウィンドウで除外済みとしてマークされますが、除外フォルダーリストには追加されません。

サンプル

次のイメージに示すように、パターン *mal.ts は、ファイル mammal.ts および animal.ts を除外します。

Excluding files by name

パターン lib は、libsrc/lib の 2 つのフォルダーを除外します。

Excluding folders by name

lib フォルダーのみを除外するには、ディレクトリページでフォルダーを選択し、除外をクリックします。

Excluding a specific folder explicitly

複数のコンテンツルートで作業する

プロジェクトには複数のコンテンツルートを置くことができます。これにより、共通の直系の親を持たない複数のディレクトリのファイルを扱うことができます。これは、静的コンテンツ(アイコンなど)を使用する場合に役立ちます。すべてフォルダーに保存し、このフォルダーをいくつかのプロジェクトでコンテンツルートとして追加するだけです。

設定ダイアログ (Ctrl+Alt+S) で、ディレクトリをクリックします。

  • コンテンツルートを追加するには、右側のペインでコンテンツルートの追加をクリックし、表示されたダイアログで必要なフォルダーを選択します。

    Add new content root
  • コンテンツルートを取り外すには、右側のペインでコンテンツルートを選択し、その隣の Cancel をクリックします。削除を確認します。対応するフォルダーは物理的に削除されないことに注意してください。

2025 年 7 月 21 日