Gitに関する記事

ブランチとか分散型とか全く理解していないので、とりあえずコミットしてログや差分を見るという使い方をした場合に利用しそうなコマンドをまとめた。
動作の確認は Git for Windows のバージョン2.10.0 上で行った。

リビジョンの指定の仕方

リビジョンを指定するためにコマンドの引数にコミットハッシュを使う場合、git log で表示されるコミットハッシュを全部書く必要はない。
git log --oneline で表示される 先頭7文字でまず問題はない。7文字で一意にリビジョンを指定できることがほとんど なので。

HEAD

HEAD は現在作業しているブランチの直近のコミットを表す。
@ も同じ意味。

HEAD~ と HEAD^

HEAD~ はHEADから1世代前のリビジョン、HEAD~N はN世代前のリビジョンを表す。
※現在のブランチを過去にたどっていく感じ？
HEAD~~ と HEAD~2 は同じ意味（2世代前のリビジョン）。

HEAD^N はHEADの親が複数ある場合（マージした場合など）にNで親を指定してそのリビジョンを表す。

HEADの後ろに "^" を続けたものは、HEADから "^" の数だけ前のリビジョンを表す。
HEAD~n は、HEADからn個前のリビジョンを現す。
つまり、下記の2つはどちらも直近のリビジョンから3つ前のリビジョンのこと。

上記のようなGitの履歴の場合、@（HEAD）を使ったリビジョンの指定は以下のようになる。

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short HEAD
485841b

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @
485841b

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short master
485841b

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short branch-a
75587e5

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short branch-b
91502d7

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @~
4dfe425

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @~~
c2099fd

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @~2
c2099fd

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @~3
5e284b8

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @^
4dfe425

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @^2
91502d7

y_ito@note MINGW64 /c/work/git_test/hoge (master)
$ git rev-parse --short @~^2
75587e5

コマンド覚え書き

Basic Snapshotting

git status
現在の状態を表示する。
git add ＜パス＞
ファイルをステージングエリアに追加する。パスはディレクトリでもファイルでもよい。ディレクトリを指定した場合はサブディレクトリ内のファイルも追加する。
git commit --allow-empty
空のコミットをする。一番最初のコミットは空にしたほうが何かと都合がいいらしい。
git commit [-m ＜コミットメッセージ＞]
コミットする。オプションを省略した場合、エディタが起動する。エディタでコミットをログを書いて内容を保存して終了するとコミットが完了する。書いた内容を破棄して終了するとコミットされない。
git commit --amend --no-edit
ステージされた内容と直前のコミットとの結合をする。コミットした後に漏れていたファイルに気付いた時やちょとした修正をして前のコミットに加えたい場合などに便利。
「どのタイミングでコミットしようか？」と迷うくらいならとりあえずコミットして、それからこのコマンドでどんどん追加していけばいい。
"--no-edit" を付けないとエディタが立ち上がってコミットログ編集画面になってしまう。
git commit --amend [-m ＜コミットメッセージ＞]
上と同じだがコミットログをついでに編集したい場合は "--no-edit" を付けずに実行する。
この記事で以前は「直前のコミットのコミットメッセージを変更する」と説明していたが、それはステージングエリアに何も追加していない状態でこのコマンドを実行すれば結果的にはコミットメッセージの変更になるということ。
git commit -a
変更されたファイルや削除されたファイルをステージしてコミットする。ようはadd＋commit。
新規作成されたファイルは対象外なので注意。
git diff [-w|-b] [-- ＜パス＞]
addする前の差分を表示する。
ステージングエリアとワークツリーの差分を表示する。と説明されているが、まだ add していない場合は何との比較なんだろう？
オプションでファイルを指定できる。ハイフン2つとパスの間にスペースが入っているので注意。
-wはスペースを無視する。
-bはスペースの数の変化を無視する。元々スペースがある場所でのスペースの追加・削除（スペースが1個以上残っている）は差分なしとされれるが、新にスペースを追加した場合やスペースを削除してその場所にスペースがなくなった場合は差分ありとなる。
git diff --name-only
差分のファイル名だけ表示する。
git diff --stat
差分の統計情報（diffstatのグラフ）を表示する。diffstatって何?
git diff --diff-filter=[A|C|D|M|R]
フィルタをかけて差分を出力する。A：追加、C：コピー、D：削除、M：変更、R：リネーム。大文字の場合は指定したもののみを、小文字の場合は指定したものを除外して出力する。
git diff --cached
git diff --staged
HEADとステージングエリアの差分を表示する。2つは同じ意味。
git diff HEAD
HEADとワークツリーの差分を表示する。ステージしたもの含めてワークツリーの変更はすべて表示される。
git diff ＜リビジョン＞ [-- ＜パス＞]
指定したリビジョンとワークツリーの差分を表示する。
リビジョンの部分を stash の名前を指定することもできる。
git diff ＜リビジョン１＞＜リビジョン2＞
git diff ＜リビジョン１＞..＜リビジョン2＞
リビジョン間の差分を表示する。2つは同じ意味。
git diff ＜リビジョン＞..HEAD --diff-filter=D --name-only
指定したリビジョンより後で削除されたファイルを表示する。
git rm [-r] --cached ＜パス＞
指定したファイルをファイル自体は残したままgitの管理対象から除外する。パスがディレクトリの場合は -r オプションが必要。
git reset [-- ＜パス＞]
ステージしたものをアンステージする。ステージングエリアは元に戻るが、ワークツリーの変更はそのまま。
パスを指定した場合は指定したファイルのみをアンステージする。
git reset --hard
ステージングエリアとワーキングツリーのすべての変更を取り消す。変更は何もかも取り消されて、ステージングエリアとワーキングエリアは直近のコミット直後のまっさらな状態になる。
git reset --soft HEAD^
直近のコミットを取り消す。ステージングエリアとワーキングツリーはそのまま。
git reset HEAD^
直近のコミットを取り消し、ステージングエリアも元に戻す。ワーキングツリーはそのまま直前のコミットの前のステージした状態になる。
git reset --hard HEAD^
直近のコミットを取り消し、ステージングエリアとワーキングツリーも元に戻す。2つ前のコミットをした直後の状態になる。
git mv ＜移動元＞＜移動先＞
ファイルを移動する。

git reset [＜モード＞] [＜リビジョン＞] については、下の方に少し説明を書いた。

Branching and Merging

git stash [push] [-m ＜メッセージ＞]
ワークツリーの現在の状態を一時的に退避する。作業途中でコミットしていない変更がある状態で rebase しようとするとエラーになって「全部コミットするかstashしろ」みたいに言われる。このコマンドで退避すると、ワークツリーはきれいな状態になってrebaseできる。
＜メッセージ＞で stash list に表示される退避した内容の説明文を指定できる。
git stash [save] [＜メッセージ＞] という書式もあるが、それは古い書式のようでこちらのドキュメントには非推奨とある。
git stash pop [＜名前＞]
退避した内容を復元する。名前を指定しない場合は最新の退避内容を復元する。
git stash apply [＜名前＞]
復元するが、退避内容は残す。
git checkout ＜名前＞＜ファイル名＞
退避した内容から指定したファイルのみを復元する。指定した退避内容は残る。
git stash list
退避した内容のリストを表示する。
git stash show ＜名前＞
指定した退避内容に含まれているファイルのファイル名を表示する。
git stash drop [＜名前＞]
退避した内容を削除する。名前を指定しない場合は最新の退避内容を削除する。
git diff ＜名前＞ [-- ＜パス＞]
退避した内容とワークツリーの差分を表示する。
git tag ＜タグ名＞ [＜リビジョン＞]
軽量タグを作成する。リビジョンの省略時のデフォルトはHEAD。
git tag -am ＜注釈＞＜タグ名＞ [＜リビジョン＞]
注釈付きタグを作成する。リビジョンの省略時のデフォルトはHEAD。
git tag
タグの一覧を表示する。
git tag -n
注釈付きでタグの一覧を表示する。軽量タグはタグが指しているリビジョンのコミットメッセージを表示する。
git tag -l ＜パターン＞
パターンに一致するタグ名のタグを表示する。パターンには例えば "v_1*" のようにワイルドカード(*)が使用できる。
git tag -d ＜タグ名＞
タグを削除する。

Inspection and Comparison

git log [-- ＜パス＞]
ログを表示する。新しいリビジョンから古いリビジョンの順番で表示する。パスを指定した場合はそのパスのファイル・ディレクトリについてのログを表示する。
git log -＜n＞
直近のn個のコミットのログを表示する。
git log ＜A＞..＜B＞
AとBの間（Aは含まずBは含む）範囲を指定してリビジョンを表示する。AとBはコミットハッシュまたはブランチ。
A,Bがブランチの場合は「Bから到達可能でAから到達不可能」なコミットのログを表示する。
git log ＜ブランチ＞
指定したブランチのコミットログを表示する。
git log ＜ブランチA＞...＜ブランチB＞
ブランチAとブランチBのいずれかから辿ることができ、かつブランチAとブランチBの両方から辿ることができないリビジョンのコミットログを表示する。ブランチの記述順は意味なく A...B と B...A は同じ。
git log --summary
追加、変更、削除したファイルを表示する。
git log --oneline
リビジョンごとに1行に簡略化したログを表示する。
git log --name-status
変更されたファイルのファイル名とステータス（A：追加、M：変更、D：削除）を表示する。
git log --name-only
変更があったファイルを表示する。
git log --grep ＜パターン＞
パターンとマッチするコミットメッセージのログを表示する。正規表現が使用可能。
git log -S＜文字列＞ [--pickaxe-regex]
コミットの差分を検索する。コミットメッセージやファイル名の検索ではなく差分そのものを検索する。
"--pickaxe-regex" オプションで正規表現が使用可能。
git log --author='＜author＞
author（コードを書いた人）を指定してログを表示する。
git log --committer='＜committer＞
committer（コミットした人）を指定してログを表示する。

git log の他のオプション

オプション	機能
--no-merges	マージコミットを除外する。
--reverse	表示順を逆にする。

git checkout -- ＜パス＞
ファイルを指定してステージする前のワークツリーの変更を元に戻す。
git show ＜リビジョンなど＞
＜リビジョンなど＞の部分にリビジョンやタグを指定して詳細を表示する。
git show ＜リビジョンなど＞:＜パス＞
ファイルを指定して表示する。

Patching

git rebase -i ＜リビジョン＞
複数のリビジョンをまとめる。下の方に少し詳しく書いた。
git revert ＜リビジョン＞
指定したリビジョンのコミットを打ち消すような差分を自動的に作成してコミットする。
git reset との違いは以下。
- 指定したリビジョンがなくなるわけではなく新たにコミットして変更内容を取り消す（履歴が残る）。
- 特定のコミットだけを指定して編集内容を取り消せること。例えば git revert HEAD~2 とした場合、HEAD~1 と HEAD~2 を取り消すのではなく、HEAD~2 だけを取り消す。

Getting and Creating Projects

git init [＜ディレクトリ＞]
リポジトリを作成する。
ディレクトリを指定した場合、そのディレクトリにリポジトリを作成する。ディレクトリが存在しない場合はディレクトリを作成してリポジトリを作る。

Debuging

grep [-i] ＜検索する文字列＞ [-- ＜パス＞]
gitの管理対象のファイルを対象にしてgrepする。
-i オプションで大文字小文字区別なし。
-- ＜パス＞ でディレクトリを指定、-- '*.拡張子' で拡張子を指定。

Setup and Config

git config [＜対象を指定するオプション＞] -l | --list
設定ファイルにある設定を一覧表示する。
git config [＜対象を指定するオプション＞] ＜設定項目名＞
設定ファイルにある指定した項目の値を表示する。
git config [＜対象を指定するオプション＞] ＜設定項目名＞＜値＞
設定ファイルにある指定した項目の値を変更する。
git config [＜対象を指定するオプション＞] --unset ＜設定項目名＞
設定を削除する。

設定ファイルについてはこちらを参照。

対象を指定するオプション（スコープ）は以下。
--system：systemの設定（そのPCでのGitの設定）
--global：globalの設定（ユーザ単位のGitの設定）
--local：localの設定（リポジトリ単位のGitの設定）

git config ＜対象を指定するオプション＞＜設定項目名＞＜値＞
設定を変更する。

設定の優先度

設定はの優先度は以下。
高<----------------->低
local、global、system

エイリアス

以下のコマンドでGitコマンド（git の後の add とか commit の部分）のエイリアスを設定できる。

git config --global alias.＜エイリアス＞ "＜Gitコマンドとオプション＞"

例：

y_ito@note MINGW64 /c/work/git_test.git (BARE:master)
$ git config --global alias.l "log --oneline"

y_ito@note MINGW64 /c/work/git_test.git (BARE:master)
$ git l
cc0b403 first commit

y_ito@note MINGW64 /c/work/git_test.git (BARE:master)
$ git config --global alias.lf "log --oneline --name-only"

y_ito@note MINGW64 /c/work/git_test.git (BARE:master)
$ git lf
cc0b403 first commit
uchinaaguchi.txt

自分が使っているエイリアス

エイリアス	動作
al	エイリアスを一覧表示する。
l	`git log --oneline`
lo	1行で `git log --oneline` よりも少し詳しくコミットログを表示する。
lf	ファイルの追加・編集・削除の状況を表示する。
lg	コミットグラフを表示する。

エイリアスの定義

git config --global alias.al "config --get-regexp alias."
git config --global alias.l "log --oneline"
git config --global alias.lo "log --oneline --pretty=format:'%h [%cd] %d %s <%an>' --date=format:'%Y-%m-%d %H:%M'"
git config --global alias.lf "log --oneline --pretty=format:'%h [%cd] %d %s <%an>' --date=short --name-status"
git config --global alias.lg "log --graph --date-order --all --pretty=format:'%h %Cred%d %Cgreen%ad %C(blue bold)%cn %Creset%s' --date=short"

その他

git --version
gitのバージョンを表示する。
git rev-parse [--short] ＜コミットハッシュ、タグ、HEADなど＞
引数で渡したものが指しているリビジョンのコミットハッシュを表示する。
--short を付ける短縮したコミットハッシュ（先頭7文字）で表示する。
逆に --short を付けずに引数が短縮したコミットハッシュだとフルのコミットハッシュを表示する。
git ls-files [＜パス＞]
gitが管理しているファイルの情報を表示する。逆に言えばgitの管理外のファイルは表示されない。
ワークツリーにファイルがなくてもgitが管理していれば表示される。パスは普通は絶対パスでもよい。
git update-index --skip-worktree ＜パス＞
ファイルを一時的にgitの管理から外す。
git update-index --no-skip-worktree ＜パス＞
ファイルをgitの管理に戻す。
git ls-files -v ＜パス＞
ファイルがgitの管理下にあるか確認する。
git update-index --skip-worktree で一時的にgitの管理から外れている場合、先頭のタグが "S" となる。

オプションの組み合わせ、gitコマンドと他のコマンドの組み合わせ

git log --oneline --name-status --diff-filter=DR ＜リビジョン＞..HEAD

指定したリビジョンより後で削除したファイルを表示する（指定したリビジョンは含まない）。
フィルターが "D" だけではないのは "D" だけでは削除したファイルを取りこぼすことがあるから。理由はファイルの削除と追加が同じリビジョンにあると「リネームした」と認識されることがあるため（git rmしたのになぜかRと認識される。なぜだ！！）。なのでリネームも加えて "DR" としてしている。

diff -u -3 <(git show <リビジョン>:<パス>) <パス>

特定のファイルについて指定したリビジョンとワークツリーの差分を見る。

git reset

git reset [＜モード＞] [＜リビジョン＞]

この書式の git reset はHEADを以前のリビジョンに戻す動作をする。
引数のリビジョンでHEADの戻し先を指定する。リビジョンを省略した場合、HEADはそのまま。

オプションのモードはワーキングツリーとステージングエリアをどうするかを指定する。
モード毎の動作を下表にまとめた。

モード	動作
--soft	ステージングエリア、ワークツリーともにそのまま。
(モードなし)	ステージングエリアは戻す。ワークツリーはそのまま。
--hard	ステージングエリア、ワークツリーともに戻す。

以上から、例えば git reset --soft はHEADを変えないしワーキングツリーもステージングエリアも戻さないので、結局何も変更しない。

git rebase -i

git rebase -i ＜リビジョン＞

このコマンドは複数のリビジョンをまとめるだけでなくいろいろなこと（コミットの分割など）もできる。
-i は --interactive としても同じで、対話的に処理することを指定するオプション。

複数のリビジョンを1つにまとめる

引数のリビジョンにはまとめたいリビジョンの中で一番古いものの1個前のリビジョンを指定する。例えばコミットの履歴が下記のようになっていて、リビジョンa93eaef（"commit C"）をリビジョン3289cc5（"commit A"）にまとめたい場合、32ca22d の1つ前の 62babdf または HEAD~4 と指定する。

$ git log --oneline --name-only
9269ac5 commit D
test02.txt
test03.txt
a93eaef commit C
test04.txt
6f0c598 commit B
test02.txt
test05.txt
3289cc5 commit A
test01.txt
test03.txt
62babdf first commit
test01.txt
test02.txt
test03.txt
test04.txt
test05.txt

git rebase -i HEAD~4 を実行すると以下の内容でviが起動する。

pick 3289cc5 commit A
pick 6f0c598 commit B
pick a93eaef commit C
pick 9269ac5 commit D

# Rebase 62babdf..9269ac5 onto 62babdf (4 commands)
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
# d, drop = remove commit
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out

"pick" で始まっている部分はコマンドの引数で指定したリビジョンの1つ後からからHEADまでのリビジョン。この部分を編集する。git log とは逆で古いものから新しいものの順番で並んでいるので注意。
それ以外の部分（空行と "#" で始まっている行）は編集する必要はない。
今回の場合、以下のように編集する。

3行目の "pick a93eaef commit C" の行をカットする。
2行目の上にカットした行の内容を挿入する。
挿入した行の "pick" を "s" また "squash" に書き換える。

※重要※
行を削除してはいけない。例えば今回のrebaseで特に変更しないからと言って commit B や commit D の行を消したりすると、消した行のコミットがなかったことになる。

編集した結果はこうなる。

pick 3289cc5 commit A
s a93eaef commit C
pick 6f0c598 commit B
pick 9269ac5 commit D

この内容を保存してviを終了する。すると今度はコミットメッセージ編集のために下記の内容でviが立ち上がる。

# This is a combination of 2 commits.
# The first commit's message is:

commit A

# This is the commit message #2:

commit C

# Please enter the commit message for your changes. Lines starting
…

今回はリビジョン a93eaef のコミットメッセージを残さないことにして、以下のように編集する。

# This is a combination of 2 commits.
# The first commit's message is:

commit A

# Please enter the commit message for your changes. Lines starting
…

この内容を保存してエディタを終了する。
コンフリクトがなければこれで2つのコミットを1つにまとめる処理は完了。
履歴を見るとリビジョン 62babdf より後のリビジョンが変わっている。”commit C" は ”commit A" に吸収されてなくなっている。”commit A"、”commit B"、”commit D" は残っているがコミットハッシュの値が変わっている。

$ git log --oneline --name-only
b131e5f commit D
test02.txt
test03.txt
2b30c00 commit B
test02.txt
test05.txt
e84109c commit A
test01.txt
test03.txt
test04.txt
62babdf first commit
test01.txt
test02.txt
test03.txt
test04.txt
test05.txt

コンフリクトした場合

コンフリクトを解決する

手動でコンフリクトを解決し、git add . して git rebase --continue とする。
ただし、自分はgitについていまいちよくわかっていないのでおとなしくrebaseを中止してリビジョンの統合をあきらめることの方が多い気がする。

rebaseを中止する

git rebase --abort

過去のコミットのコミットログだけ編集する

コミットログ操作過去のコミットのコメントだけを修正したい | 逆引きGit | サルでもわかるGit入門〜バージョン管理を使いこなそう〜 | どこでもプロジェクト管理バックログ
 git rebase についてまとめてみた reword-コミットメッセージをまとめて変更する - Qiita
Gitのコミットメッセージをまとめて修正する - はらへり日記

エクスポート（アーカイブ）

特定のリビジョンのエクスポート

git archive --format=zip [--prefix=＜ディレクトリ名＞/] [--worktree-attributes] ＜リビジョン＞ [＜パス＞] -o ＜出力ファイル名＞

パスを指定すれば特定のファイルのみ・ディレクトリに限定してエクスポートすることができる。
--worktree-attributes については後述。

アーカイブから除外するファイルの指定

gitで管理しているがアーカイブには入れたくないファイルがある場合 .gitattributes というファイルをワークツリーのルートに作り、

＜除外したいファイル＞ export-ignore

と記述する。そして git archive に --worktree-attributes オプションを付けて実行する。

差分のエクスポート

git archive --format=zip [--prefix=＜ディレクトリ名＞/] HEAD `git diff --diff-filter=d --name-only ＜リビジョン＞..HEAD` -o ＜出力ファイル名＞

指定したリビジョン以降の変更ファイルをzipファイルにエクスポートする。
--prefix=＜ディレクトリ名＞/ （最後にスラッシュを忘れるな！！）があると、zipに含まれるファイルすべてのパスの先頭に指定したディレクトリ名が付く。つまり展開すると指定した名前のディレクトリが作成されて、そこを基点として各ファイルが展開される。