WebStorm 2026.1 Help

バージョン管理統合サポート

WebStorm はバージョン管理統合を 2 レベルでサポートしています:

  • IDE レベルでは、VCS 統合は、デフォルトで有効になって いるバンドルされたプラグインのセットを通じて提供されます。

  • project レベルでは、project フォルダーを 1 つまたは複数のバージョン管理システムと関連付けることで、VCS 統合が有効になります。

プロジェクトルートをバージョン管理システムに関連付ける

WebStorm を使うと、プロジェクトのバージョン管理システム連携をすばやく有効化し、プロジェクトルートに関連付けることができます。 個別のプロジェクトディレクトリを異なるバージョン管理システムに関連付ける方法の詳細については、「ディレクトリをバージョン管理システムに関連付ける 」を参照してください。

  1. Alt+` を押して VCS 操作のポップアップ を開き、 バージョン管理連携を有効化 を選択します。

    あるいは、 VCS | VCS 連携を有効にする に進みます。

  2. 開いた バージョン管理連携を有効化 ダイアログで、 プロジェクトフォルダーに関連付けるバージョン管理システムを選択します。

  3. VCS 統合が有効になると、WebStorm は VCS を介してプロジェクト設定ファイルを共有するかどうかを確認します。 常に追加 を選択して、WebStorm で作業する他のリポジトリユーザーとプロジェクト設定を同期できます。

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

    これは Git および Mercurial のみ適用されることに注意してください。

次の手順については以下を参照してください:

ディレクトリマッピングを構成する

WebStorm は、ディレクトリベースのバージョン管理モデルをサポートしています。つまり、各プロジェクトディレクトリを異なるバージョン管理システムに関連付けることができます。

ディレクトリをバージョン管理システムに関連付ける

  1. Ctrl+Alt+S を押して設定を開き、 バージョン管理 | ディレクトリマッピング を選択します。

  2. ディレクトリマッピング ページには、プロジェクトディレクトリとそれに関連付けられたバージョン管理システムのリストが表示されます(ディレクトリが追加されていない場合、リストにはプロジェクトルートのみが含まれます)。

  3. 右側の 追加 ボタン をクリックします。

  4. 開いた VCS ディレクトリマッピングの追加 ダイアログで、 ディレクトリ オプションを選択します。 バージョン管理システムに関連付けるディレクトリへのパスを入力するか、 閲覧する ボタン 参照ボタン をクリックして、表示されるダイアログでディレクトリを選択します。

  5. VCS リストから、このディレクトリ内のファイルを制御するために使用されるバージョン管理システムを選択します。 このリストには、対応する プラグインが現在有効になっているバージョン管理システムのみが含まれていることに注意してください。

  6. OK をクリックしてマッピングを保存し、 ディレクトリマッピング ページに戻ります。

未登録のディレクトリを管理する

Git または Mercurial 連携が有効なプロジェクトの場合、WebStorm はプロジェクトディレクトリをスキャンして、IDE によって管理されていない Git/Mercurial リポジトリが存在するかどうかを確認します。 そのようなリポジトリが検出されると、WebStorm は通知を表示します。

未登録のルートを追加するには、通知内の ルートの追加 リンクをクリックします。 または、 バージョン管理の設定ページを開き、追加する未登録のルート (灰色でマークされています) を選択し、 ディレクトリをバージョン管理システムに関連付ける の手順に従います。

これらのルートについて通知されたくない場合は、通知内の 無視 リンクをクリックしてください。 新規の未登録リポジトリがプロジェクトに追加された場合、WebStorm はそれについて通知します。

VCS の関連付けを変更する

  1. Ctrl+Alt+S を押して設定を開き、 バージョン管理 | ディレクトリマッピング を選択します。

  2. ディレクトリマッピング ページには、プロジェクトディレクトリとそれに関連付けられたバージョン管理システムのリストが表示されます(ディレクトリが追加されていない場合、リストにはプロジェクトルートのみが含まれます)。

  3. 別のバージョン管理システムに置きたいディレクトリに対応する行を見つけます。

  4. VCS 列をクリックしてください。 表示されたリストから、新しいバージョン管理システムを選択します。

  5. OK をクリックしてマッピングを保存し、 ディレクトリマッピング ページに戻ります。

2026 年 6 月 8 日