3 つのエリア
git add と git commit の違いが分からない。これは Git 初学者の最初の壁で、原因は「Git には 3 つの場所 がある」ことを知らないからです。
3 つの場所
┌──────────────┐ git add ┌──────────────────┐ git commit ┌──────────────┐
│ ワークツリー │ ─────────▶ │ ステージングエリア │ ──────────▶ │ リポジトリ │
│ (作業ディレクトリ)│ │ (インデックス) │ │ (.git の履歴) │
└──────────────┘ └──────────────────┘ └──────────────┘
実際のファイル 次のコミットに入れる 確定したスナップショット
変更の「選抜メンバー」 の鎖ワークツリー(Working Tree)
あなたがエディタで開いて編集している、実際のファイル です。ls で見えるもの。ここで何をしても Git はまだ何も記録していません。
ステージングエリア(Staging Area / Index)
「次のコミットに含める変更」を置いておく場所です。git add した変更がここに入ります。
なぜこんな中間の場所があるのか。それは 変更を選んでコミットできる ようにするためです。README とプログラムを同時に直したとき、「README の修正」「プログラムの修正」という 2 つのコミットに分けられます。
リポジトリ(Repository)
git commit で確定した スナップショットの履歴 です。.git フォルダの中に保存されています。ここに入ったものは、ほぼ何があっても取り戻せます。
git status の読み方
git status は、この 3 つの場所の 差 を報告しています。
Changes to be committed: ← ステージとリポジトリの差(緑)
new file: a.txt = 次のコミットに入る
Changes not staged for commit: ← ワークツリーとステージの差(赤)
modified: b.txt = 変えたけど add していない
Untracked files: ← Git が知らないファイル(赤)
c.txt = 一度も add されていない同じファイルが緑と赤の両方に出ることもあります。「add したあとにさらに編集した」ときです。add した時点の内容がステージに、その後の編集がワークツリーにあります。
git diff の読み方
git diff にもこの構造がそのまま反映されています。
| コマンド | 比べるもの |
|---|---|
git diff | ワークツリー ↔ ステージ |
git diff --staged | ステージ ↔ リポジトリ(HEAD) |
git diff HEAD | ワークツリー ↔ リポジトリ(HEAD) |
「add したら git diff に何も出なくなった」のは、ワークツリーとステージが同じになったからです。
逆方向に動かす
| やりたいこと | コマンド | 何が起きるか |
|---|---|---|
| ステージから降ろす | git restore --staged <file> | ステージをリポジトリの内容に戻す。ワークツリーはそのまま |
| ワークツリーの変更を捨てる | git restore <file> | ワークツリーをステージの内容に戻す。編集内容が消える |
| 直前のコミットを取り消す | git reset --soft HEAD~1 | リポジトリの HEAD だけ戻す。ステージはそのまま |
よくある疑問
Q. 毎回 add するのが面倒です
A. 追跡済みファイルなら git commit -a で add を省略できます。ただし新しいファイルは必ず git add が必要です。git add . で全部載せることもできます。
Q. add したファイルを編集したらどうなる?
A. ステージには add した時点の内容が残り、その後の変更はワークツリーにだけあります。もう一度 git add すると最新になります。
Q. ステージングは本当に必要? A. 小さく分けてコミットする習慣がつくと、履歴が読みやすくなり、レビューも楽になります。最初は「add してから commit」の 2 段階、と機械的に覚えて大丈夫です。
手を動かして確かめる
このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。