WebStorm 2026.1 Help

Git リポジトリのセットアップを行う

既存の Git リポジトリを クローンするか、 既存のプロジェクトを Git バージョン管理下に置くと、WebStorm はコンピューターに Git がインストールされているか自動的に検出します。 IDE が Git 実行可能ファイルを見つけられない場合、それをダウンロードすることを提案します。

WebStorm は Windows 10 バージョン 2004 で利用可能な Linux 用の Windows Subsystem (WSL2) の Git をサポートします。

Git が Windows にインストールされていない場合、WebStorm は WSL で Git を検索し、そこから使用します。 また、 \\wsl$ パスを使用して開かれるプロジェクトの場合、WebStorm は WSL から Git に自動的に切り替えます。

WSL の Git を WebStorm で手動設定する必要がある場合は、 バージョン管理 | Git 設定ページ  Ctrl+Alt+S に移動し、 Git 実行可能ファイルのパス フィールドの 閲覧する アイコンをクリックして、 \wsl$ パス(例: \\wsl$\debian\usr\bin\git )経由で WSL の Git を選択します。

リモートホストからプロジェクトをチェックアウトする (git クローン)

WebStorm を使用すると、既存のリポジトリをチェックアウト(Git の用語では クローン )し、ダウンロードしたデータに基づいて新しいプロジェクトを作成できます。

  1. Git リポジトリのクローンを開始するには、次のいずれかを行います:

    • バージョン管理統合がすでに有効になっている場合は、 Git | クローン に進みます。

    • バージョン管理統合がまだ有効になっていない場合は、 VCS | バージョン管理から取得​ に進みます。

      あるいは、 ファイル | 新規 | バージョン管理からプロジェクト に進みます。

    • 現在開いているプロジェクトがない場合は、 ようこそ 画面で リポジトリのクローン をクリックします。

  2. リポジトリのクローン ダイアログで、クローンを作成するリモートリポジトリの URL を指定するか、左側で VCS ホスティングサービスの 1 つを選択します。

    選択したホスティングサービスにすでにログインしている場合、補完によってクローン可能な利用可能なリポジトリのリストが表示されます。

    限定された履歴で 浅いクローン(英語)を実行する場合は、 履歴が切り捨てられた浅いクローン チェックボックスを選択し、クローンするコミットの数を指定します。

    メインメニューで Git | 浅いリポジトリ を選択すると、後で残りの履歴を取得できます。

  3. クローン をクリックしてください。 複製したソースに基づいてプロジェクトを作成する場合は、確認ダイアログで はい をクリックします。 Git ルートマッピングは、プロジェクトのルートディレクトリに自動的に設定されます。

    プロジェクトに サブモジュール(英語)が含まれている場合、それらも複製され、プロジェクトルートとして自動的に登録されます。

  4. プロジェクト '<project_name>' を信頼して開きますか? プロジェクトセキュリティダイアログで、プロジェクトを開く方法を選択します: プロジェクトを信頼 または セーフモードでプレビュー

既存のプロジェクトを Git バージョン管理下に置く

既存のプロジェクトソースを基にローカル Git リポジトリを作成できます。

project 全体を単一の Git リポジトリに関連付ける

  1. Git に入れたい project を開きます。

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

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

  3. バージョン管理システムとして Git を選択し、 OK をクリックします。

    プロジェクト全体が単一の Git ディレクトリに関連付けられます。 その後、 Git で追跡したいファイルをローカルリポジトリに追加します

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

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

プロジェクト内のさまざまなディレクトリをさまざまな Git リポジトリに関連付ける

  1. Git に置きたいディレクトリを開きます。

  2. メインメニューで VCS | Git リポジトリの作成 へ移動します。

  3. 表示されたダイアログで、新しい Git リポジトリを作成するディレクトリを指定してください。

    Git は外部パスをサポートしていないため、プロジェクトルートの外にディレクトリを選択した場合、そのフォルダーにもプロジェクトルートが含まれていることを確認してください。

  4. project 構造内に複数の Git リポジトリを作成する場合は、各ディレクトリについて前の手順を繰り返してください。

プロジェクトの Git リポジトリを初期化した後、プロジェクトファイルをリポジトリに追加する必要があります。

ローカルリポジトリにファイルを追加する

  1. コミット ツールウィンドウ(Alt+0 )で、 バージョン管理外ファイル ノードを展開します。

  2. Git または変更リスト全体に追加するファイルを選択し、 Ctrl+Alt+A を押すか、コンテキストメニューから VCS に追加 を選択します。

    プロジェクト ツールウィンドウ(Alt+1 )からローカル Git リポジトリにファイルを追加することもできます。追加するファイルを選択し、 Ctrl+Alt+A を押すか、コンテキストメニューから Git | 追加 を選択してください。

project で Git 統合が有効な場合、WebStorm は外部から追加されたファイルも含めて、新規ファイルを Git に追加することを提案します。 この動作は、 バージョン管理 | 確認 設定ページ Ctrl+Alt+S で変更できます。 特定のファイルを常にバージョン管理しないままにしたい場合は、 無視できます。

バージョン管理からファイルを除外する (無視)

特定のファイルをバージョン管理しないでおく必要がある場合があります。 これらには、VCS 管理ファイル、ユーティリティのアーティファクト、バックアップコピーなどがあります。 WebStorm を使ってファイルを無視でき、IDE ではそれらファイルを Git へ追加する提案をせず、無視されたファイルとしてハイライトされます。

無視できるのは、 バージョン管理されていないファイル、つまり バージョン管理外ファイル 変更リストにあるファイルのみです。 ファイルが Git に追加されてコミットされていない場合は、 コミット ウィンドウでファイルを右クリックし、 ロールバック を選択できます。

Git では、無視するファイルパターンを 2 種類の構成ファイルに記述できます:

  • .git/info/exclude ファイル。

    このファイルに記載されたパターンは、リポジトリのローカルコピーにのみ適用されます。

    このファイルは、Git リポジトリを初期化またはチェックアウトしたときに自動で作成されます。

  • VCS ルートディレクトリとそのサブディレクトリにある 1 つ以上の .gitignore ファイル。

    これらのファイルはリポジトリにチェックインされるため、ファイル内の無視パターンをチーム全体が利用できるようになります。 無視されたファイルパターンを保存する最も一般的な場所です。

    VCS ルートディレクトリに .gitignore ファイルがない場合、 プロジェクト ツールウィンドウの任意の場所を右クリックし、 新規 | ファイル を選択して、 新規ファイル ダイアログに .gitignore と入力します。

ファイルを .gitignore または .git/info/exclude に追加する

  1. どの種類の Git 構成ファイルを使ってファイルを無視するか決めます。 疑わしい場合は、 .gitignore を使用してください。

  2. コミット ウィンドウまたは プロジェクト ツールウィンドウ (Alt+1) で、無視したいバージョン管理されていないファイルまたはフォルダーを探します。 これらのビューのファイルの色はファイルの状態を識別できます。

  3. 選択項目を右クリックし、 Git | .gitignore に追加する または Git | .git/info/exclude に追加 を選択します。

    これらのビューのファイルの色は、ファイルの状態を識別するのに役立ちます。

特定のパターンまたはタイプによってファイルを除外する必要がある場合は、 .gitignore または .git/info/exclude ファイルを直接編集できます。 .gitignore パターンフォーマット(英語)を参照してください。

リモートリポジトリを追加する

ローカルソースに基づいて Git リポジトリを作成した場合は、コードベース全体をローカルに保存するリスクを排除するだけでなく、Git プロジェクトで共同作業できるようにリモートリポジトリを追加する必要があります。 作業を共有し、そこからデータを 取得して 、他のコントリビューターが行った変更をローカルリポジトリバージョンに統合する必要がある場合は、変更をリモートリポジトリに プッシュします

たとえば、 GitHub(英語) から リモート Git リポジトリを複製した場合、リモートは自動的に構成され、それと 同期するときに指定する必要はありません。 Git がクローン元のリモートに付けるデフォルト名は、 origin です。

リモートを定義する

  1. BitbucketGitHubGitLab など任意の Git ホスティングに空のリポジトリを作成します。 WebStorm を離れることなく GitHub または GitLab にリポジトリを作成できます。詳しくは GitHub でプロジェクトを共有GitLab でプロジェクトを共有 を参照してください。

  2. メインメニューから Git | プッシュ を選択してコミットをプッシュする準備ができたら、 プッシュ ダイアログを起動するか、 Ctrl+Shift+K をプッシュします。

  3. 開いたダイアログで、リモートの名前とホストする URL を指定します。

    リモートのフェッチ オプションを選択すると、ブランチリストとコミット履歴もすぐに 取得されます

2 台目のリモートを追加

場合によっては、2 番目のリモートリポジトリも追加する必要があります。 これは、たとえば、書き込みアクセス権を持たないリポジトリのクローンを作成し、元のプロジェクトの独自の フォークに変更をプッシュする場合に便利です。 もう 1 つの一般的なシナリオは、他人のプロジェクトフォークである独自のリポジトリのクローンを作成し、元のプロジェクトと同期してそこから変更を取得する必要があるというものです。

  1. メインメニューで、 Git | リモートの管理 に移動します。 Git リモート ダイアログが開きます。

  2. ツールバーの 追加 add ボタンをクリックするか、 Alt+Insert を押してください。

  3. 表示されたダイアログで、リモートの名前と URL を指定し、 OK をクリックします。

このビデオからさらに詳しく学ぶ:

Git リモートのパスワードを設定する

リモート Git リポジトリと対話するたびに(たとえば、 プル更新 、または プッシュ操作中)、許可が必要です。 WebStorm でパスワードを記憶するように構成できるので、認証が必要なたびに資格情報を入力する必要はありません。

パスワードポリシーを設定する

  1. 設定 ダイアログ Ctrl+Alt+S で、左側の 外観 & 振る舞い | システム設定 | パスワード を選択します。

  2. WebStorm が Git リモートリポジトリのパスワードをどのように処理するかを選択します:

    • ネイティブキーチェーンを使用する: ネイティブのキーチェーンを使用してパスワードを保存するには、このオプションを選択します。 この設定は、macOS および Linux でのみ使用できます。

    • KeePass を使用する: KeePass パスワードマネージャー(英語)を使用してパスワードを保存するには、このオプションを選択します。 KeePass パスワードマネージャー を使用する場合、個別のパスワードを保存するファイルにアクセスするためにマスターパスワードが使用されます。 WebStorm がパスワードを記憶すると、パスワードデータベースへのアクセスが必要な場合を除き、パスワードの入力は求められません。 c.kdbx ファイルへのアクセスに使用するパスワードを MasterPassword フィールドに入力します。

      データベース フィールドで、 c.kdbx ファイルのデフォルトの場所を変更することができます。

      c.kdbx ファイルをインポートするには、 設定アイコン をクリックしてドロップダウンメニューから インポート を選択するか、 参照ボタン をクリックしてパスワードを含むローカルファイルへのパスを指定します。

      既存のパスワードをデータベースから削除する場合は、 クリア を選択します。

    • 保存せずに再起動後にパスワードを忘れる :WebStorm を閉じた後にパスワードをリセットしたい場合はこのオプションを選択します。

2026 年 6 月 8 日