GitHub Desktop でのブランチの管理

GitHub Desktop を使用して、リポジトリ内の既存のブランチから新しいブランチを作成して、変更を安全に試してみることができます。

Platform navigation

この記事の内容

ブランチの管理について

ブランチを使用して、プロジェクトの変更を安全に試すことができます。 ブランチは、開発作業をリポジトリ内の他のブランチから分離します。 たとえば、ブランチを使用して新しい機能を開発したり、バグを修正したりすることができます。

ブランチは常に既存のものから作成します。 通常、リポジトリのデフォルトブランチからブランチを作成します。 その後、他の人がリポジトリに加えた変更とは別に、新しいブランチで作業できます。

ブランチの履歴で、以前のコミットから始まるブランチを作成することもできます。 これは、バグを調査するためにリポジトリの以前のビューに戻る必要がある場合や、最新リリースの上にホットフィックスを作成する必要がある場合に役立ちます。

作業が完了したら、プルリクエストを作成して、現在のブランチの変更を別のブランチにマージできます。 詳細については、「GitHub Desktop からの issue または pull request の作成」および「pull requests について」を参照してください。

リポジトリへの読み取りアクセスがある場合は、常に GitHub Desktop でブランチを作成できますが、リポジトリへの書き込みアクセスがある場合のみ、ブランチを GitHub にプッシュできます。

リポジトリ管理者は、ブランチの保護を有効化できます。 保護されたブランチで作業しているなら、ブランチを削除したり、ブランチにフォースプッシュしたりすることはできません。 リポジトリ管理者は、他の保護されたブランチの設定を有効化して、ブランチがマージできるようになる前に特定のワークフローを強制することができます。 詳しくは、「保護されたブランチについて」を参照してください。

リポジトリ管理者も、ルールセットを有効にすることができます。 ルールセットを使用すると、新しいブランチを作成するときに特定のブランチ名を要求したり、バイパス アクセス許可を持つユーザーのみに新しいブランチをリモート リポジトリへの発行を許可したりできます。 GitHub Desktop は警告を表示し、ブランチがルールセットに従っていない場合、ブランチが作成されないようにします。 詳しくは、「ルールセットについて」をご覧ください。

ブランチの作成

Tip

最初に作成する新しいブランチは、既定のブランチに基づきます。 複数のブランチがある場合、現在チェックアウトされているブランチまたはデフォルトのブランチに基づいて、新しいブランチを選択できます。

  1. アプリの上部で [現在のブランチ] をクリックし、ブランチの一覧から、新しいブランチのベースにしたいブランチをクリックしてください。

    [現在のブランチ] ドロップダウン ビューのスクリーンショット。 [Recent Branches] (最近のブランチ) の下にある "my-feature" というブランチがオレンジの枠線で強調表示されています。

  2. [New Branch] (新しいブランチ) をクリックします。

    [現在のブランチ] ドロップダウン ビューのスクリーンショット。 [フィルター] フィールドの横の [新しいブランチ] というラベルのボタンがオレンジ色で囲まれています。

  3. [ブランチの作成] ウィンドウの [名前] に新しいブランチの名前を入力します。

  4. [ブランチ作成のベース] で新しいベース ブランチを選びます。

  5. [Create Branch] (ブランチの作成) をクリックします。

以前のコミットからブランチを作成する

  1. 左サイドバーにある [履歴] をクリックします。

    サイドバーの [履歴] タブのスクリーンショット。 コミット一覧の上にある [履歴] というタブ ボタンがオレンジ色の枠線で強調表示されています。

  2. 新しいブランチを作成するコミットを右クリックし、 [コミットからブランチの作成] を選択します。

    [履歴] タブのコミットの一覧のスクリーンショット。コミットの横のコンテキスト メニューで、カーソルが [コミットからブランチの作成] オプションをポイントしています。

  3. [ブランチの作成] ウィンドウの [名前] に新しいブランチの名前を入力します。

  4. [Create Branch] (ブランチの作成) をクリックします。

ブランチを公開する

GitHub にブランチを作成する場合は、ブランチを公開して、GitHub でのコラボレーションに使用できるようにする必要があります。

  1. リポジトリ バーの [現在のブランチ] をクリックし、公開するブランチをクリックします。
    [現在のブランチ] ドロップダウン ビューのスクリーンショット。 [Recent Branches] (最近のブランチ) の下にある "my-feature" というブランチがオレンジの枠線で強調表示されています。
  2. [ブランチを公開する] をクリックします。
    リポジトリ バーのスクリーンショット。 右側の [ブランチを公開する] というラベルのボタンがオレンジ色の枠線で強調されています。

ブランチ間の切り替え

リポジトリのどんなブランチに対しても、コミットを表示したり、コミットを行ったりすることができます。 まだコミットしていない、保存した変更がある場合は、その変更の扱いについて、ブランチを切り替える前に決める必要があります。 現在のブランチに変更をコミットする、現在のブランチへの変更を一時的に保存するために stash する、または変更を新しいブランチに移動することが可能です。 ブランチを切り替える前に変更をコミットしたい場合は、「GitHub Desktop でプロジェクトの変更をコミットしてレビューする」をご覧ください。

Tip

ブランチを切り替える場合の既定の動作は、[Prompts] で設定できます。 詳しくは、「GitHub Desktop での基本設定の構成」をご覧ください。

  1. リポジトリ バーの [現在のブランチ] をクリックし、切り替え先のブランチをクリックします。
    [現在のブランチ] ドロップダウン ビューのスクリーンショット。 [Recent Branches] (最近のブランチ) の下にある "my-feature" というブランチがオレンジの枠線で強調表示されています。
  2. コミットされていない変更を保存した場合は、[ブランチの切り替え] ウィンドウで、 [変更を CURRENT-BRANCH に残す] または [変更を NEW-BRANCH に反映する] を選んで、 [ブランチの切り替え] をクリックします。

ブランチの削除

現時点でブランチがオープンなプルリクエストに関連付けられている場合は、ブランチを削除できません。 ブランチの削除を取り消すことはできません。

  1. リポジトリ バーの [現在のブランチ] をクリックし、削除するブランチをクリックします。
    [現在のブランチ] ドロップダウン ビューのスクリーンショット。 [Recent Branches] (最近のブランチ) の下にある "my-feature" というブランチがオレンジの枠線で強調表示されています。
  2. メニュー バーの [Branch] (ブランチ) をクリックし、 [Delete...] (削除) をクリックします。Shift+Command+D を押すこともできます。
    Mac のメニュー バーのスクリーンショット。 展開された [分岐] ドロップダウン メニューで、青で強調表示されている [削除] オプションの上にカーソルがあります。
  1. リポジトリ バーの [現在のブランチ] をクリックし、削除するブランチをクリックします。
    [現在のブランチ] ドロップダウン ビューのスクリーンショット。 [Recent Branches] (最近のブランチ) の下にある "my-feature" というブランチがオレンジの枠線で強調表示されています。
  2. メニュー バーの [Branch] (ブランチ) をクリックし、 [Delete...] (削除) をクリックします。Ctrl+Shift+D を押すこともできます。
    Windows の [GitHub Desktop] メニュー バーのスクリーンショット。 展開された [ブランチ] ドロップダウン メニューで、[削除] というラベルのオプションがオレンジ色の枠線で囲まれています。

参考資料