IntelliJ IDEA 2024.1 ヘルプ

Git リポジトリのセットアップ

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

IntelliJ IDEA は、Windows10 バージョン 2004(英語) で使用可能な Windows Subsystem for Linux 2(WSL2)の Git をサポートします。

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

WSL から Git を使用するように IntelliJ IDEA を手動で構成する必要がある場合は、設定 Ctrl+Alt+Sバージョン管理 | Git ページに移動し、Git 実行可能ファイルのパスフィールドの参照アイコンをクリックして、\wsl$ パス (例: \\wsl$\debian\usr\bin\git) を介して WSL から Git を選択します。

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

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

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

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

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

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

    • 現在開いているプロジェクトがない場合は、ウェルカム画面で VCS から取得をクリックします。

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

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

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

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

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

  5. プロジェクトを初めてインポートまたは複製すると、IntelliJ IDEA がプロジェクトを分析します。IDE が複数の構成(たとえば、Eclipse と Gradle)を検出すると、使用する構成を選択するように求められます。

    必要な構成を選択して、OK をクリックします。

    Dialog that prompts you to select how you want to import the project

    IDE は、選択に応じてプロジェクトを事前構成します。例: Gradle を選択すると、IntelliJ IDEA はビルドスクリプトを実行し、依存関係をロードします。

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

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

プロジェクト全体を単一の Git リポジトリに関連付けます

  1. Git の中に入れたいプロジェクトを開きます。

  2. Alt+` を押して VCS 操作のポップアップを開き、VCS 連携を有効にするを選択します。

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

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

    プロジェクト全体が単一の Git ディレクトリに関連付けられるため、各ファイルを Git ディレクトリに個別に追加する必要はありません。

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

    Notification prompting to select how to treat configuration files

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

  1. Git の中に入れたいプロジェクトを開きます。

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

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

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

  4. プロジェクト構造内に複数の Git リポジトリを作成している場合は、各ディレクトリに対して前の手順を繰り返します。

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

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

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

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

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

プロジェクトで Git 統合が有効になっている場合、IntelliJ IDEA は、新しく作成された各ファイルを、たとえそれが IntelliJ IDEA の外部から追加されたものであっても、Git に追加することを提案します。この動作は、設定 Ctrl+Alt+Sバージョン管理 | 確認ページで変更できます。特定のファイルを常にバージョン管理しないままにしたい場合は、無視できます。

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

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

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

Git では、2 種類の構成ファイルで無視されたファイルパターンをリストできます。

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

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

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

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

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

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

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

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

  2. 変更ビューまたはプロジェクトツールウィンドウで、無視するバージョン管理されていないファイルまたはフォルダーを見つけます。これらのビューのファイルの色は、ファイルのステータスを識別できます。

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

    これらのビューのファイルの色は、ファイルのステータスを識別できます。

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

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

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

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

さまざまなプロジェクト形式のプロジェクト設定の共有の詳細については、「VCS を介してプロジェクト設定を共有する」を参照してください。

リモートを定義する

  1. Bitbucket(英語)GitHub(英語) などの Git ホスティングに空のリポジトリを作成します。IntelliJ IDEA を移動せずに GitHub にリポジトリを作成できます。GitHub でプロジェクトを共有するを参照してください。

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

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

2 台目のリモートを追加

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

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

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

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

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

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

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

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

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

  2. IntelliJ IDEA が Git リモートリポジトリのパスワードを処理する方法を選択します。

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

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

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

      c.kdbx ファイルをインポートするには、the Settings icon をクリックしてドロップダウンメニューからインポートを選択するか、the Browse button をクリックしてパスワードを含むローカルファイルへのパスを指定します。

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

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

関連ページ:

プロジェクトのセキュリティ

潜在的なセキュリティリスクを防ぐために、IntelliJ IDEA では、プロジェクトのソースがわからない場合にプロジェクトを開く方法を決定できます。IntelliJ IDEA は、オープニングプロセス中に実行されるタスクまたは構成について警告し、信頼できるソースを構成できるようにします。不明なソースからプロジェクトを開く:プロジェクトを開くと、IntelliJ IDEA を使用すると、未知ソースコードを含むプロジェクトの処理方法をすぐに決定できます。プロジェクトを初めて開くたびに、IDE に...

Maven

IntelliJ IDEA は Maven との完全な機能統合をサポートしており、構築プロセスの自動化に役立ちます。新しい Maven プロジェクトを簡単に作成したり、既存のプロジェクトを開いて同期したり、既存の IntelliJ IDEA プロジェクトに Maven サポートを追加したり、マルチモジュールプロジェクトを構成および管理したりできます。Maven プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを...

Gradle

IntelliJ IDEA は Gradle との完全な機能統合をサポートしており、構築プロセスの自動化に役立ちます。新しい Gradle プロジェクトを簡単に作成し、既存のプロジェクトを開いて同期し、リンクされた複数のプロジェクトを同時に操作して管理することができます。Gradle プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを参照してください。新規 Gradle プロジェクトを作成する新規プロジェクト...

Git リポジトリに変更をコミットしてプッシュする

Git リポジトリに新しいファイルを追加するか、すでに Git バージョン管理下にあるファイルを変更し、現在の状態に満足したら、作業の結果を共有できます。これには、ローカルにコミットしてリポジトリのスナップショットをプロジェクト履歴に記録し、次にリモートリポジトリにプッシュして他のユーザーが使用できるようにすることが含まれます。Git ユーザー名を設定する Git は、コミットを ID に関連付けるために、ユーザー名を知っている必要があります。ユーザー名を設定していない場合、IntelliJ ID...

ファイルステータスのハイライト

ファイルステータス:プロジェクトツールウィンドウでは、ファイルをさまざまな色で表示でき、コード分析の結果やバージョン管理状態などに応じて、エディタータブをハイライトできます。設定のバージョン管理 | ファイルステータスの色ページで VCS ファイルのステータスの色を設定できます。一部でリストのデフォルトのファイルステータスの色と意味下表のカラースキーム。#0A7700 追加済みアクティブな変更リストのファイルは、リポジトリへの追加がスケジュールされています。#0EAA00 非アクティブ変更リスト...

リモート Git リポジトリと同期する (フェッチ、プル、更新)

変更をアップストリームにプッシュして作業結果を共有する前に、リモートリポジトリと同期して、プロジェクトのローカルコピーが最新であることを確認する必要があります。これを行うには、次のいずれかの方法があります: 変更のフェッチ、変更のプル、プロジェクトの更新 Git ブランチポップアップは、ブランチにまだフェッチされていない受信コミットがあるかどうかを示します。変更のフェッチ:アップストリームから変更をフェッチすると、リモートリポジトリと最後に同期してから行われたコミットからのすべての新しいデータがロー...