WebStorm 2026.1 Help

プロジェクト設定

WebStorm では、特定のプロジェクトごとや IDE 全体で設定を構成できます。 詳細については、 IDE の構成を参照してください。

プロジェクトレベルの設定は、現在のプロジェクトにのみ適用されます。 これらの設定は、プロジェクトフォルダーの .idea ディレクトリに xml ファイルとして保存されます。

  • <project name>.iml ファイルはプロジェクト構造を記述します。

  • workspace.xml ファイルには、 実行 / デバッグ構成 などのワークスペース設定が含まれています。

  • xml ファイルは、 projectCodeStyle.xml encodings.xml vcs.xml などの名前で認識できる独自の設定セットを担当します。

    たとえば、新しい実行 / デバッグ構成を追加してエンコーディングを変更すると、2 つの異なる xml ファイルに影響します。 これにより、プロジェクト設定がバージョン管理システムに格納され、異なるチームメンバーによって変更されたときのマージの競合を回避できます。

プロジェクト設定を構成するには、メインメニューから macOS では %instance% | 設定​ 、Windows と Linux では ファイル | 設定 を選択します。 または、 Ctrl+Alt+S を押して IDE 設定を表示することもできます。

設定 ダイアログでは、現在のプロジェクトにのみ適用されるプロジェクト設定が プロジェクト設定 アイコンでマークされます。 その他の設定は グローバルであり、既存のすべてのプロジェクトに適用されます。

設定でマークされたプロジェクト abd グローバル設定ダイアログ

プロジェクト設定を共有する

チームで同じプロジェクトを作業する場合はプロジェクト設定を共有すると便利ですが、複数のマシンで WebStorm を使う場合は ide 設定のバックアップと同期 が役立ちます。

プロジェクトがバージョン管理下にある場合は、 workspace.xml を除く .idea ディレクトリのすべての XML ファイルもバージョン管理下に置くことをお勧めします。 workspace.xml ファイルには、共有してはならないユーザー固有の設定が格納されています。

無視すべき内容の詳細については、「GitHub の JetBrains.gitignore(英語) 」を参照してください。

設定ファイルは選択に応じて処理されます。 プロジェクト設定を変更して新しい設定ファイルが作成されると、IDE は画面の下部にこのプロジェクトの設定ファイルの扱い方を選択するように促す通知を表示します。

  • ファイルを表示: 作成された設定ファイルのリストを確認し、バージョン管理下に置くファイルを選択します。 その後、選択したファイルが VCS に追加されるようスケジュールされます。

  • 常に追加: VCS に追加するために .idea ディレクトリに作成されたすべての設定ファイルをサイレントにスケジュールします(現在のプロジェクトにのみ適用されます)。

  • 今後このメッセージを表示しない :構成ファイルを VCS への追加のためにスケジュールしないでください。手動で VCS に追加するまで、 バージョン管理外ステータスのままになります(現在のプロジェクトのみに適用されます)。

オプションを選択せずに通知を閉じると、新しい設定ファイルが作成された後に再び表示されます。 IDE を再起動しても、新しいファイルはオプションの 1 つを選択するまでそこにあるリストにも移動します。

設定ファイルの扱い方を選択するよう促す通知

共有できない構成ファイルのリスト

WebStorm は構成ファイルを識別し、自動的に無視されるファイルのリストに追加します。 ただし、プロジェクトを手動で共有している場合は、これらのファイルとフォルダーをバージョン管理下に置かないことをお勧めします。

  • .idea/workspace.xml

  • .idea/usage.statistics.xml

  • .idea/dictionaries フォルダー

  • .idea/shelf フォルダー

ファイルの完全なリストについては、 バージョン管理システムでプロジェクトを管理する方法および JetBrains.gitignore(英語) を参照してください。

グローバル設定をプロジェクトレベルにコピーする

グローバル (IDE) 設定はプロジェクトとは別に保存されます。 このため、これらの設定はバージョン管理を通じてプロジェクトとともに共有されません。

ただし、一部の設定はプロジェクトレベルにコピーできます。 例えば、 インスペクション プロファイルのコピーや、 コード補完と自動インポートから除外されたクラスおよびパッケージのリストを作成できます。 これを行うと、IDE によって対応する設定ファイルが .idea ディレクトリに作成され、VCS を通じてプロジェクトと共有できます。

既存のプロジェクト間でプロジェクト設定を共有するには、 バックアップと同期プラグインを使用することもできます。 設定を ZIP アーカイブにエクスポートし、後で他の IDE インスタンスにインポートすることもできます。

新しいプロジェクトのデフォルト設定

現在のプロジェクトだけでなく、後で作成するすべてのプロジェクトのプロジェクト設定を構成できます。 つまり、プロジェクトに新しいデフォルト設定を設定できます。

新しいプロジェクトのデフォルト設定にアクセスする

  • メインメニューで ファイル | 新規プロジェクトのセットアップ | 設定 for New Projects へ移動します。

新しいプロジェクトで再現したい設定と構成を持つプロジェクトがある場合、このプロジェクトをカスタムプロジェクトテンプレートとして保存し、このテンプレートを製品の作成に使用できます。 プロジェクトテンプレートの詳細を参照してください。

既存のプロジェクト間でプロジェクト設定を共有したい場合は、 バックアップと同期プラグインを使用できます。 設定を ZIP アーカイブにエクスポートし、後で他の IDE インスタンスにインポートすることもできます。

2026 年 6 月 8 日