7. git add の正体 — ステージは「次のtreeの下書き」

新卒がまず戸惑うのが「なぜcommitの前にaddが要るのか」です。内部構造から見ると、addとcommitはまったく別の仕事をしています。

① addとcommitの分担

2つのコマンドがそれぞれ何を作るか

作業ツリーあなたが編集するファイル

git add — 中身をblobにしてDBへ入れ、一覧に載せる

ステージ(index)パス → blobハッシュの一覧

git commit — 一覧からtreeを組み立て、commitで包む

tree + commitオブジェクトDBへ

「addを忘れてcommitしたら変更が入っていなかった」という失敗は、commitがステージだけを見ているためです。

同じファイルの3つの姿

作業ツリーversion 3(最新の編集)

ステージversion 2(addした時点)

最新コミットversion 1

この状態で commit すると

version 2 が記録されるversion 3 は入らない

1つのファイルが同時に3つの姿を持ちうる、というのがGitの状態管理です。ステージという中間層があることで、変更を選んでコミットできます。

学んだ概念を、素朴な例から実務寄りの例まで5つの具体例で確認します。