-
1. はじめに
- 1.1 バージョン管理について
- 1.2 Gitの簡単な歴史
- 1.3 Gitとは何か?
- 1.4 コマンドライン
- 1.5 Gitのインストール
- 1.6 Gitの初回設定
- 1.7 ヘルプの取得
- 1.8 まとめ
-
2. Gitの基本
- 2.1 Gitリポジトリの取得
- 2.2 リポジトリへの変更の記録
- 2.3 コミット履歴の表示
- 2.4 元に戻す
- 2.5 リモートとの連携
- 2.6 タグ付け
- 2.7 Gitエイリアス
- 2.8 まとめ
-
3. Gitブランチ
- 3.1 ブランチの概要
- 3.2 基本的なブランチとマージ
- 3.3 ブランチ管理
- 3.4 ブランチワークフロー
- 3.5 リモートブランチ
- 3.6 リベース
- 3.7 まとめ
-
4. サーバー上のGit
- 4.1 プロトコル
- 4.2 サーバーへのGitのインストール
- 4.3 SSH公開鍵の生成
- 4.4 サーバーの設定
- 4.5 Gitデーモン
- 4.6 スマートHTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 サードパーティホストオプション
- 4.10 まとめ
-
5. 分散型Git
- 5.1 分散ワークフロー
- 5.2 プロジェクトへの貢献
- 5.3 プロジェクトの維持管理
- 5.4 まとめ
-
6. GitHub
- 6.1 アカウント設定と構成
- 6.2 プロジェクトへの貢献
- 6.3 プロジェクトの維持管理
- 6.4 組織の管理
- 6.5 GitHubスクリプティング
- 6.6 まとめ
-
7. Gitツール
- 7.1 リビジョン選択
- 7.2 インタラクティブステージング
- 7.3 スタッシュとクリーン
- 7.4 作業への署名
- 7.5 検索
- 7.6 履歴の書き換え
- 7.7 リセットの謎を解く
- 7.8 高度なマージ
- 7.9 Rerere
- 7.10 Gitを使ったデバッグ
- 7.11 サブモジュール
- 7.12 バンドル
- 7.13 置換
- 7.14 資格情報の保存
- 7.15 まとめ
-
8. Gitのカスタマイズ
- 8.1 Gitの設定
- 8.2 Git属性
- 8.3 Gitフック
- 8.4 Gitによるポリシー適用例
- 8.5 まとめ
-
9. Gitと他のシステム
- 9.1 Gitをクライアントとして使う
- 9.2 Gitへの移行
- 9.3 まとめ
-
10. Git内部構造
- 10.1 内部コマンドと外部コマンド
- 10.2 Gitオブジェクト
- 10.3 Gitリファレンス
- 10.4 パックファイル
- 10.5 Refspec
- 10.6 転送プロトコル
- 10.7 メンテナンスとデータ復旧
- 10.8 環境変数
- 10.9 まとめ
-
付録A. 他の環境でのGit
- A1.1 グラフィカルインターフェース
- A1.2 Visual StudioでのGit
- A1.3 Visual Studio CodeでのGit
- A1.4 IntelliJ/PyCharm/WebStorm/PhpStorm/RubyMineでのGit
- A1.5 Sublime TextでのGit
- A1.6 BashでのGit
- A1.7 ZshでのGit
- A1.8 PowerShellでのGit
- A1.9 まとめ
-
付録B. アプリケーションへのGitの埋め込み
- A2.1 コマンドラインGit
- A2.2 Libgit2
- A2.3 JGit
- A2.4 go-git
- A2.5 Dulwich
-
付録C. Gitコマンド
- A3.1 設定と構成
- A3.2 プロジェクトの取得と作成
- A3.3 基本的なスナップショット
- A3.4 ブランチとマージ
- A3.5 プロジェクトの共有と更新
- A3.6 検査と比較
- A3.7 デバッグ
- A3.8 パッチ
- A3.9 メール
- A3.10 外部システム
- A3.11 管理
- A3.12 内部コマンド
3.2 Gitブランチ - 基本的なブランチとマージ
基本的なブランチとマージ
現実世界のワークフローにおけるブランチとマージの簡単な例を見てみましょう。以下の手順に従います。
-
ウェブサイトで作業を行います。
-
作業中の新しいユーザーストーリー用のブランチを作成します。
-
そのブランチで作業を行います。
この段階で、別の問題が緊急でホットフィックスが必要であるという連絡を受けたとします。次の手順を実行します。
-
本番ブランチに切り替えます。
-
ホットフィックスを追加するためのブランチを作成します。
-
テスト後、ホットフィックスブランチをマージして本番環境にプッシュします。
-
元のユーザーストーリーに戻り、作業を続けます。
基本的なブランチ操作
まず、プロジェクトに取り組んでおり、`master`ブランチにいくつかのコミットがあるとします。

会社の課題管理システムで、課題番号53に取り組むことにしました。新しいブランチを作成して同時に切り替えるには、`-b`スイッチ付きの`git checkout`コマンドを実行します。
$ git checkout -b iss53
Switched to a new branch "iss53"
これは以下のコマンドの省略形です。
$ git branch iss53
$ git checkout iss53

ウェブサイトで作業を行い、いくつかのコミットを行います。これにより、`iss53`ブランチが前進します。なぜなら、チェックアウトされている(つまり、`HEAD`がそれを指している)からです。
$ vim index.html
$ git commit -a -m 'Create new footer [issue 53]'

ウェブサイトに問題が発生し、すぐに修正する必要があるという連絡を受けたとします。Gitを使用すれば、行ったiss53
の変更と一緒に修正プログラムをデプロイする必要がなく、修正プログラムを本番環境に適用する前にそれらの変更を元に戻すために多くの労力を費やす必要もありません。やるべきことは、master
ブランチに切り替えるだけです。
ただし、その前に、作業ディレクトリまたはステージングエリアに、チェックアウトするブランチと競合するコミットされていない変更がある場合、Gitはブランチの切り替えを許可しません。ブランチを切り替える際には、クリーンな作業状態にするのが最善です。これを回避する方法(つまり、スタッシュとコミットの修正)については、後でスタッシュとクリーンアップで説明します。ここでは、すべての変更をコミット済みと仮定し、master
ブランチに戻るとします。
$ git checkout master
Switched to branch 'master'
この時点で、プロジェクトの作業ディレクトリは、問題#53に取り組み始める前とまったく同じ状態になり、ホットフィックスに集中できます。これは重要な点です。ブランチを切り替えると、Gitは作業ディレクトリを、そのブランチに最後にコミットした時の状態にリセットします。ファイルの追加、削除、変更を自動的に行い、作業コピーが前回のコミット時のブランチの状態と一致するようにします。
次に、ホットフィックスを作成する必要があります。完了するまで作業するhotfix
ブランチを作成しましょう。
$ git checkout -b hotfix
Switched to a new branch 'hotfix'
$ vim index.html
$ git commit -a -m 'Fix broken email address'
[hotfix 1fb7853] Fix broken email address
1 file changed, 2 insertions(+)

master
に基づくホットフィックスブランチテストを実行し、ホットフィックスが意図したものであることを確認し、最後にgit merge
コマンドを使用してhotfix
ブランチをmaster
ブランチにマージして本番環境にデプロイします。
$ git checkout master
$ git merge hotfix
Updating f42c576..3a0874c
Fast-forward
index.html | 2 ++
1 file changed, 2 insertions(+)
そのマージで「高速転送」というフレーズに気付くでしょう。マージしたhotfix
ブランチが指すコミットC4
は、現在いるコミットC2
の直接の先祖であったため、Gitは単にポインタを前方に移動します。言い換えると、あるコミットを、最初のコミットの履歴に従って到達できるコミットとマージしようとすると、Gitはマージする分岐した作業がないため、ポインタを前方に移動することで処理を簡素化します。これを「高速転送」と言います。
変更は、master
ブランチが指すコミットのスナップショットに含まれるようになり、修正プログラムをデプロイできます。

master
はhotfix
に高速転送されます。非常に重要な修正プログラムをデプロイしたら、中断される前に実行していた作業に戻ることができます。ただし、最初にhotfix
ブランチは不要になったため(master
ブランチが同じ場所を指しているため)、削除します。git branch
に-d
オプションを付けて削除できます。
$ git branch -d hotfix
Deleted branch hotfix (3a0874c).
これで、問題#53の作業中のブランチに戻って作業を続けることができます。
$ git checkout iss53
Switched to branch "iss53"
$ vim index.html
$ git commit -a -m 'Finish the new footer [issue 53]'
[iss53 ad82d7a] Finish the new footer [issue 53]
1 file changed, 1 insertion(+)

iss53
での作業継続ここで注意すべき点は、hotfix
ブランチで行った作業は、iss53
ブランチのファイルに含まれていないことです。取り込む必要がある場合は、git merge master
を実行してmaster
ブランチをiss53
ブランチにマージするか、後でiss53
ブランチをmaster
ブランチにプルバックすることにするまで、これらの変更の統合を待つことができます。
基本的なマージ
問題#53の作業が完了し、master
ブランチにマージする準備ができたとします。そのためには、先ほどhotfix
ブランチをマージしたように、iss53
ブランチをmaster
ブランチにマージします。やるべきことは、マージ先のブランチをチェックアウトし、git merge
コマンドを実行することだけです。
$ git checkout master
Switched to branch 'master'
$ git merge iss53
Merge made by the 'recursive' strategy.
index.html | 1 +
1 file changed, 1 insertion(+)
これは、先ほど行ったhotfix
のマージとは少し異なります。この場合、開発履歴は以前のある時点から分岐しています。現在いるブランチのコミットがマージするブランチの直接の先祖ではないため、Gitは作業を行う必要があります。この場合、Gitは、ブランチの先端が指す2つのスナップショットと、その2つの共通の祖先を使用して、単純な3方向マージを実行します。

ブランチポインタを単純に前方に移動するのではなく、Gitはこの3方向マージの結果として新しいスナップショットを作成し、それを指す新しいコミットを自動的に作成します。これはマージコミットと呼ばれ、複数の親を持つ特殊なコミットです。

作業がマージされたので、iss53
ブランチは不要になりました。問題追跡システムで問題を閉じ、ブランチを削除できます。
$ git branch -d iss53
基本的なマージ競合
時々、このプロセスはスムーズに進みません。マージする2つのブランチで同じファイルの同じ部分を異なる方法で変更した場合、Gitはそれらをクリーンにマージできません。問題#53の修正が、hotfix
ブランチと同じファイルの同じ部分を変更した場合、次のようなマージ競合が発生します。
$ git merge iss53
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.
Gitは新しいマージコミットを自動的に作成していません。競合を解決している間にプロセスを一時停止しています。マージ競合が発生した後に、どのファイルがマージされていないかを調べるには、git status
を実行できます。
$ git status
On branch master
You have unmerged paths.
(fix conflicts and run "git commit")
Unmerged paths:
(use "git add <file>..." to mark resolution)
both modified: index.html
no changes added to commit (use "git add" and/or "git commit -a")
マージ競合があり、解決されていないものはすべて、マージされていないものとしてリストされます。Gitは、競合のあるファイルに標準的な競合解決マーカーを追加するため、それらを手動で開き、競合を解決できます。ファイルには次のようなセクションが含まれています。
<<<<<<< HEAD:index.html
<div id="footer">contact : email.support@github.com</div>
=======
<div id="footer">
please contact us at support@github.com
</div>
>>>>>>> iss53:index.html
これは、HEAD
(git merge
コマンドを実行したときにチェックアウトしていたmaster
ブランチ)のバージョンがそのブロックの上部(=======
の上のすべて)であり、iss53
ブランチのバージョンが下部のすべてであることを意味します。競合を解決するには、どちらか一方を選択するか、内容を自分でマージする必要があります。たとえば、この競合を次のように置き換えることで解決できます。
<div id="footer">
please contact us at email.support@github.com
</div>
この解決策には各セクションの一部が含まれており、<<<<<<<
、=======
、>>>>>>>
行は完全に削除されています。各競合ファイルのこれらのセクションをすべて解決したら、各ファイルに対してgit add
を実行して、解決済みとしてマークします。ファイルをステージングすると、Gitで解決済みとしてマークされます。
グラフィカルツールを使用してこれらの問題を解決する場合は、git mergetool
を実行できます。これにより、適切なビジュアルマージツールが起動し、競合を案内します。
$ git mergetool
This message is displayed because 'merge.tool' is not configured.
See 'git mergetool --tool-help' or 'git help config' for more details.
'git mergetool' will now attempt to use one of the following tools:
opendiff kdiff3 tkdiff xxdiff meld tortoisemerge gvimdiff diffuse diffmerge ecmerge p4merge araxis bc3 codecompare vimdiff emerge
Merging:
index.html
Normal merge conflict for 'index.html':
{local}: modified file
{remote}: modified file
Hit return to start merge resolution tool (opendiff):
デフォルト以外のマージツールを使用する場合は(このコマンドはmacOSで実行されたため、Gitはopendiff
を選択しました)、 「one of the following tools」の後にリストされているすべてのサポートされているツールを確認できます。代わりに使用したいツールの名前を入力するだけです。
注記
|
複雑なマージ競合を解決するための高度なツールが必要な場合は、高度なマージでマージについて詳しく説明しています。 |
マージツールを終了すると、Gitはマージが成功したかどうかを尋ねます。スクリプトに成功したことを伝えると、ファイルがステージングされて解決済みとしてマークされます。git status
を再度実行して、すべての競合が解決されたことを確認できます。
$ git status
On branch master
All conflicts fixed but you are still merging.
(use "git commit" to conclude merge)
Changes to be committed:
modified: index.html
それで満足していて、競合があったものがすべてステージングされていることを確認したら、git commit
と入力してマージコミットを確定できます。コミットメッセージはデフォルトで次のようになります。
Merge branch 'iss53'
Conflicts:
index.html
#
# It looks like you may be committing a merge.
# If this is not correct, please remove the file
# .git/MERGE_HEAD
# and try again.
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# On branch master
# All conflicts fixed but you are still merging.
#
# Changes to be committed:
# modified: index.html
#
将来このマージを見る人に役立つと思われる場合は、マージを解決した方法の詳細をこのコミットメッセージに追加し、変更が明らかでない場合は行った変更の説明を追加できます。