$Git Simulator
壊しても大丈夫。全部ブラウザの中だけで動いています

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 段階、と機械的に覚えて大丈夫です。

手を動かして確かめる

このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。