PhpStorm 2026.3 Help

チュートリアル: PhpStorm で Git 入門

このチュートリアルでは、PhpStorm で最も一般的な Git 操作を実行する方法を説明します。

このコースでは、プロジェクト用の Git リポジトリの作成方法、GitHub での共有方法、変更のコミットとプッシュ方法、ブランチの作成とマージ方法、マージの競合の解決方法、ファイルの履歴の調査方法を学びます。

ステップ 1. Git リポジトリで新しいプロジェクトを作成する

このチュートリアルでは、簡単なprojectを作成し、それを GitHub で共有し、いくつかの Git タスクを実行します。

  1. IntelliJ IDEA を起動します。

    PhpStorm のホーム画面で、 新規 | プロジェクト をクリックします。 すでにプロジェクトを開いている場合は、メインメニューから ファイル | 新規プロジェクト を選択します。

  2. 新規プロジェクト ウィザードで、 新規プロジェクト リストからプロジェクトタイプを選択し(このチュートリアルでは 空のProject を作成します)、プロジェクト名(例: gitdemo )を指定し、保存場所のパスを指定します。

    Git リポジトリの作成 オプションを選択してください。

    %alt_new_project
  3. 作成 をクリックします。 新しいprojectが PhpStorm で開きます。

project用のローカル Git リポジトリが作成されたことを通知するメッセージが表示されます。

Git リポジトリを使用して新しいプロジェクトを作成したため、Git を操作するための専用ツールウィンドウが利用可能になります。

Git 統合が有効
  1. VCS ウィジェット: Git およびブランチを管理し 、Git の基本的な操作を実行します。

  2. コミット ツールウィンドウ (Ctrl+K または 表示 | ツールウィンドウ | コミット): ローカルの変更を確認し 、ローカルの Git リポジトリに コミットします。

  3. Git ツールウィンドウ(Alt+9 または 表示 | ツールウィンドウ | Git): Git ログの操作や その他の操作。

ステップ 1. Git にファイル追加

Git 統合が有効になると、PhpStorm はどのファイルが変更され、どの新しいファイルが Git に追加されたか、どのファイルが Git によって追跡されていないかを表示します。

仕組みを学ぶために、簡単な説明を書いた簡単な README.md ファイルを作成し、それを Git に追加してみましょう。

  1. Project ツールウィンドウ(Alt+1 )で、プロジェクトディレクトリ(gitdemo )を選択します。

  2. ツールウィンドウのツールバーにある 新規ファイルまたはディレクトリ をクリック(または Alt+Insert を押す)し、リストから ファイル を選択します。 ファイル名を README.md にして Enter を押します。

  3. 開いたダイアログで、 追加 をクリックして、Git がファイルの追跡を開始できるようにします。

    Git に新しいファイルを追加する

    これで、このファイルを変更すると、PhpStorm によって変更内容が自動的にインデックス化される (つまり、 Git ステージングエリア(英語)に追加される) ため、手動で変更する必要がなくなります。

  4. 新しく作成したファイルに次のテキストを追加します。

    # Tutorial This is a tutorial where you will learn how to create Git repositories from your projects and share them on GitHub.

    Enter キーを押して、このテキストの後に新しい行がファイル内に作成されるようにしてください。 これは後ほど、マージの競合を解決する方法を学ぶ際に使用します。

    テキストがファイルに追加されました

これで新しいファイルは Git によって追跡され、 コミット ツールウィンドウ (Alt+0) の 変更 変更リストに追加されます。

新しく作成されたファイルで変更リストを変更する

変更 の変更リストは、Git リポジトリにまだコミットされていないローカルの変更を管理できます。 詳しくは 変更を変更リストにグループ化する を参照してください。

ステップ 2. プロジェクトをローカル Git リポジトリにコミットする

次に、共有したいすべてのファイルをリポジトリに追加し、コミットして現在の状態を保存しましょう。

  1. コミット ツールウィンドウ(Alt+0 )で、コミットしたいファイルの横にあるチェックボックスをクリックして選択します。

  2. 最初のコミットのメッセージを入力してください(例: Add a new project to Git):

  3. コミット をクリックします。

    お使いのコンピューターで Git を使用したことがない場合は、変更をコミットする直前に PhpStorm がユーザー名とメールアドレスの入力を求めます。 Git はこれらの情報を .git/config に保存し、コミットの作成者としてあなたを割り当てます。

    PhpStorm は、コミットが成功した後に通知します。

    コミットされたファイルの通知

ステップ 4. GitHub でプロジェクトを共有する

projectを他のコントリビューターに公開するには、リモートリポジトリ(たとえば GitHub または GitLab )に公開する必要があります。 PhpStorm はこれらのプラットフォームの両方との統合を提供しています。 詳細は GitHub でホストされているプロジェクトを管理する および GitLab でホストされているプロジェクトを管理する を参照してください。

このチュートリアルでは、projectを GitHub に公開します。

  1. メインメニューで、 Git | GitHub | GitHub でプロジェクトを共有Git | GitHub | GitHub でプロジェクトを共有 に移動します。

  2. 開いたダイアログでは、リポジトリ名(デフォルトではプロジェクト名と同じ)、リモートの名前(デフォルトでは origin )、リポジトリの種類(公開または非公開)を変更したり、必要に応じて説明を追加したりできます。

    リポジトリ名 と リモート のフィールドはデフォルト値のままにしてください。 非公開 オプションを選択してください。

    GitHub に登録されていない場合は、 アカウントの追加 をクリックしてから GitHub でログイン をクリックします。

    GitHub のシェアプロジェクトダイアログ

    開いたブラウザーウィンドウに GitHub の認証情報を入力するか、そこで新しいアカウントを作成してください。 PhpStorm に戻ると、 共有する フィールドにアカウント名が表示されます。

  3. 共用 をクリックします。 プロジェクトが GitHub で正常に公開されると、次の通知が表示されます。

    リポジトリは GitHub で共有されています

    通知のリンクをクリックして、GitHub のリポジトリを開きます。

ステップ 5. 新規ブランチの作成

たとえば、新しい機能に取り組んでいて、テスト前に変更をメインのブランチに反映させたくない場合には、別のブランチを作成する必要があります。

  1. Ctrl+T を押すか、 Git | プロジェクトの更新 に移動します。 開いた プロジェクトの更新 ダイアログで、デフォルトのマージオプションのままにします。 現在のブランチの最新バージョンをプルするには、 OK をクリックします。

    プロジェクトの更新ダイアログが開く
  2. VCS ウィジェットには、現在のブランチ名 — main が表示されます。 それをクリックし、 ローカル ノードで main ブランチを選択してから、 「メイン」からの新しいブランチ を選択します。

    Git ブランチメニュー
  3. 開いたダイアログで、ブランチの名前(例: new_feature )を指定し、 ブランチをチェックアウトする オプションを選択すると、すぐに新しいブランチに切り替わります。

    新しい Git ブランチ

    これで、新しく作成されたブランチに切り替わります。

    新しいブランチに切り替え

ステップ 6. 変更を加えて表示する

  1. projectに新しいファイル (たとえば、 git-features.md) を追加し、PhpStorm がそれを Git バージョン管理に追加することを提案したら、 追加 をクリックします。

    その後、 README.md ファイルを開き、既存のテキストを新しい説明に置き換えます。

    # Demo This is a demo project where you will learn how to commit and push changes, create and merge branches. Refer to `git-features.md` to check the list of Git operations.

    Project ツールウィンドウ (Alt+1) とエディタータブで、PhpStorm はファイルに異なる色を適用します: 変更済みは青、新規追加は緑です。 さらに、変更済みファイルのガター領域では、変更された行の横に色付きの変更マーカーが表示されます。

    エディターとプロジェクトツールウィンドウの変更
  2. 具体的に何が変更されたかを確認するには、ガターマーカーをクリックします。

    色付きの変更マーカー

    別のエディタータブで違いを表示するには、 差分の表示アイコン行の差異を表示 をクリックしてください。

    範囲の差分
  3. すべての変更を一度にプレビューするには、 コミット ツールウィンドウ(Alt+0 )に移動してください。 ファイルをダブルクリックすると、エディターで差分ビューが開きます。

    ローカルの変更

    詳細は Git リポジトリの変更を調査する を参照してください。

ステップ 7. 変更をコミットしてプッシュする

new_feature ブランチでは、新しい git-features.md ファイルを作成し、 README.md ファイルを変更しました。 変更をコミットして、リモートリポジトリにプッシュしましょう。

  1. コミット ツールウィンドウ(Alt+0 )で、両方のファイルの横にあるチェックボックスを選択し、コミットメッセージ(例: Update README.md )を入力します。

    コミットメッセージを入力する際、プロジェクトファイル名には 自動補完 (Ctrl+Space )を使用できます。

    コミットメッセージの補完

    コミット をクリックします。

  2. Ctrl+Shift+K をプッシュするか、メインメニューから Git | プッシュ を選択して、変更内容をリモートリポジトリにプッシュします。 コミットのプッシュ ダイアログが開きます。 ここで、プッシュされるすべてのコミットと、影響を受けるすべてのファイルを確認できます。

    変更をプッシュする前に、各ファイルの違いを確認できます。 これを行うには、ファイルを右クリックして 差分の表示アイコン差分の表示 を選択するか、 Ctrl+D をプッシュします。

    コミットのプッシュ
  3. プッシュ をクリックします。

    その後、PhpStorm はすべての変更を GitHub 上のリモートリポジトリにプッシュします。

ステップ 8. ブランチをマージし、競合を解決する

あるブランチから別のブランチに変更を適用する方法はいくつかあります。たとえば、ブランチのマージやリベース、コミットのチェリーピック、個別の変更またはファイルの適用などです。 これらのメソッドはすべて、 マージ、リベース、チェリーピックで変更を適用 で詳しく説明されています。

このチュートリアルでは、2 つのブランチをマージする方法を学びます。 また、PhpStorm のマージツールを使用してマージの競合を簡単に解決する方法を学ぶために、意図的にマージの競合を発生させます。

ブランチのマージ

  1. Git ブランチ ウィジェットで main ブランチを選択し、 チェックアウト をクリックします。

  2. ステップ 6 では、 new_feature ブランチ内の README.md ファイルを変更しました。 次に、マージの競合をシミュレートするために、 main ブランチ内のテキストをもう一度更新してみましょう。

    # Tutorial This is a test project where you will learn how to work with the most popular Git operations.

    ステップ 2 で行ったように、このテキストの後に新しい行が作成されるように、 Enter を押してください。 これは、後々の競合解決に役立ちます。

  3. ステップ 7 の説明に従って変更をコミットしてプッシュします。 コミットメッセージを記述します (例: Add information about Git tutorial)。

  4. VCS ウィジェットの ローカル ノードで、 new_feature を選択し、 「new_feature」を「main」にマージする をクリックします。

    VCS ウィジェットメニューのマージオプション

異なるブランチの同じファイルに変更を加えたため、 競合 ダイアログが表示されます。

競合ダイアログ

競合の解決

  1. 競合 ダイアログには、競合を解決するためのいくつかのオプションがあります。

    • 自分側を適用 は、現在のブランチで行われた変更を保持します。

    • 相手側を適用 は、現在のブランチにマージする変更を適用します。

    • 専用のダイアログで手動で競合を解決するには、 マージ。

    マージ をクリックします。 リビジョンをマージ ダイアログが開きます。

    競合を解決
    • メインからの変更点 と呼ばれる左側のペインには、ローカルコピーからの読み取り専用の変更が表示されます。

    • new_feature からの変更点 と呼ばれる右側のペインには、 main にマージする new_feature ブランチからの読み取り専用の受信変更が表示されます。

    • 結果 と呼ばれる中央のペインは、競合を解決した結果を表示する、完全に機能するエディターです。

  2. このダイアログでは、 the Apply changes from the left/the Apply changes from the right をクリックして変更を承認するか、 をクリックして変更を却下し、中央の 結果 ペインにコードを入力できます。 詳しくは Git の競合を解決する を参照してください。

    左ペインの main からの変更を 1 つ受け入れるために、 the Apply changes from the left をクリックします。 同じ行に対する new_feature からの変更は不要なので、右ペインの赤い競合行にある 除去 をクリックして破棄します。

    new_feature からの残りの競合しない変更については、右側のペインで the Apply changes from the right をクリックします。

    中央のパネルで結合結果を確認します。 結合されたテキストは次のようになります。

    # Demo This is a test project where you will learn how to work with the most popular Git operations. Refer to `git-features.md` to check the list of Git operations.
    解決された矛盾
  3. 適用 をクリックします。

    PhpStorm は new_feature ブランチを main ブランチに統合します。

  4. Ctrl+Shift+K をプッシュするか、メインメニューから Git | プッシュ を選択して、変更をリモートリポジトリにプッシュします。

Git ツールウィンドウ(Alt+9 )の ログ タブで、すべてのブランチのコミットを確認できます。

Git ログタブ

ここから、コミットを元に戻したり、あるブランチから別のブランチに変更をチェリーピックしたりすることもできます。 詳しくは ログタブ を参照してください。

ステップ 9. 履歴を表示

他の人とprojectで作業する場合、このファイルがなぜ、いつ、どのように変更されたのかといった疑問が生じることがあります。

main ブランチ内の README.md ファイルを開きます。 これらの変更がどのコミットからのものなのかを確認するには、次のいずれかを実行します。

  • エディター内または Project ツールウィンドウ(Alt+1 )でファイルを右クリックし、「Git | 履歴の表示 」を選択します。 Git ツールウィンドウの History タブが開きます。

    Git ファイルの履歴

    このタブでは、ファイルに影響を与えたすべてのコミットを表示し、関心のある変更が追加されたコミットを確認できます。

  • エディターで、履歴を表示したいコード断片を選択し、選択範囲を右クリックして「Git | 選択範囲の履歴を表示 」を選択します。 すると、「選定の歴史 」ダイアログが開きます。

    選択の Git 履歴

    ここでは、関心のあるコード選択に影響を与えたすべてのコミットを確認できます。

Git 履歴を詳しく見るその他の方法については、 Git リポジトリの変更を調査する で確認できます。

要約

このチュートリアルでは、次の方法を学習しました。

次のステップ

このチュートリアルで特定の Git タスクの実行方法が見つからなかった場合は、 Git ガイドラインを参照してください - IDE で使用できるすべての Git 操作がそこで説明されています。

projectが Git に該当しない場合でも、 ローカル履歴機能を使用して、ローカルの変更を追跡および管理したり、特定のファイル状態にロールバックしたり、削除されたファイルを復元したりすることができます。

2026 年 11 月 9 日