ブランチの管理について
ブランチを使用して、プロジェクトの変更を安全に試すことができます。 ブランチは、開発作業をリポジトリ内の他のブランチから分離します。 たとえば、ブランチを使用して新しい機能を開発したり、バグを修正したりすることができます。
ブランチは常に既存のものから作成します。 通常、リポジトリのデフォルトブランチからブランチを作成します。 その後、他の人がリポジトリに加えた変更とは別に、新しいブランチで作業できます。
作業が完了したら、プルリクエストを作成して、現在のブランチの変更を別のブランチにマージできます。 詳しい情報については、「Issue またはプルリクエストを作成する」および「プルリクエストについて」を参照してください。
リポジトリへの読み取りアクセスがある場合は、常に GitHub Desktop でブランチを作成できますが、リポジトリへの書き込みアクセスがある場合のみ、ブランチを GitHub にプッシュできます。
リポジトリ管理者は、ブランチの保護を有効化できます。 保護されたブランチで作業しているなら、ブランチを削除したり、ブランチにフォースプッシュしたりすることはできません。 Repository administrators can enable other protected branch settings to enforce specific workflows before a branch can be merged. 詳しい情報については保護されたブランチについてを参照してください。
ブランチの作成
参考: 最初に作成する新しいブランチは、デフォルトのブランチに基づいています。 複数のブランチがある場合、現在チェックアウトされているブランチまたはデフォルトのブランチに基づいて、新しいブランチを選択できます。
- At the top of the app, click Current Branch and then in the list of branches, click the branch that you want to base your new branch on.
- New Branch(新規ブランチ)をクリックしてください。
- Name(名前)の下で、新しいブランチの名前を入力してください。
- Use the drop-down to choose a base branch for your new branch.
- Create Branch(ブランチの作成)をクリックしてください。
- At the top of the app, click Current Branch and then in the list of branches, click the branch that you want to base your new branch on.
- New Branch(新規ブランチ)をクリックしてください。
- Name(名前)の下で、新しいブランチの名前を入力してください。
- Use the drop-down to choose a base branch for your new branch.
- Create Branch(ブランチの作成)をクリックしてください。
ブランチを公開する
GitHub にブランチを作成する場合は、ブランチを公開して、GitHub でのコラボレーションに使用できるようにする必要があります。
- アプリの上部で、 [Current Branch] をクリックし、公開するブランチをクリックします。
- [Publish branch] をクリックします。
ブランチ間の切り替え
リポジトリのどんなブランチに対しても、コミットを表示したり、コミットを行ったりすることができます。 まだコミットしていない、保存した変更がある場合は、その変更の扱いについて、ブランチを切り替える前に決める必要があります。 現在のブランチに変更をコミットする、現在のブランチに変更を stash する、または変更を新しいブランチに移動することが可能です。 変更を現在のブランチにコミットしたい場合は、ブランチを切り替える前に、「プロジェクトへの変更をコミットまたはレビューする」の手順に従ってください。
Tip: Advanced(高度)な設定で、ブランチの切り替え時のデフォルトの動作を設定できます。 詳しい情報については、「基本的な設定」を参照してください。
- In GitHub Desktop, click Current Branch.
- ブランチのリストで、切り替えたいブランチをクリックしてください。
- 保存していて、まだコミットしていない変更がある場合は、[Leave my changes] または [Bring my changes] を選択してから、[Switch Branch] をクリックしてください。
stash した変更を取得する
他のブランチで stash した変更にアクセスするには、変更を stash したブランチに切り替えます。
- In GitHub Desktop, click Current Branch.
- ブランチのリストで、切り替えたいブランチをクリックしてください。
- 左サイドバーで [Stashed Changes] をクリックします。
- stash した変更を削除するには、[Discard] をクリックします。stash した変更を利用するには、[Restore] をクリックします。
ブランチの削除
現時点でブランチがオープンなプルリクエストに関連付けられている場合は、ブランチを削除できません。 ブランチの削除を取り消すことはできません。
- At the top of the app, click Current Branch, then click the branch that you want to delete.
- In your menu bar, click Branch, then click Delete.... You can also press shift⌘ commandD.
- At the top of the app, click Current Branch, then click the branch that you want to delete.
- In your menu bar, click Branch, then click Delete.... You can also press CtrlShiftD.
参考リンク
- 「GitHub Desktopからのリポジトリのクローン方法」
- GitHub 用語集中のブランチ
- ブランチについて
- Gitのドキュメンテーション中のブランチの要約