3つの場所とコミット — status・add・commit・diff

git status の読み方

1. 前の回でも打った git status を、詳しく読みます。git status は、作業ツリー・ステージ・HEAD のコミットの3つを見比べて、どこに差があるか を教えるコマンドです。何かをする前とした後に、まずこれで今の状態を確かめます。

2. 3つの場所がどれも同じ中身のとき、git status は nothing to commit, working tree clean と答えます。片付いている、という意味です。

   $ git status
   On branch main
   nothing to commit, working tree clean

3. ファイルを書き換えます。変わるのは 作業ツリーだけ です。

   $ echo "パンを買う" >> todo.txt

4. 赤字の modified が Changes not staged for commit の下に出ました。これは 作業ツリーとステージの差 です。まだ add していない変更、という意味です。

   $ git status
   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   todo.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

5. git add で、作業ツリーの中身をステージに写します。

   $ git add todo.txt

6. 今度は緑の Changes to be committed に移りました。これは ステージと HEAD のコミットの差 です。次のコミットに入る変更、という意味です。

   $ git status
   On branch main
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	modified:   todo.txt
   

7. add したあとで、同じファイルにもう1行足します。

   $ echo "バターを買う" >> todo.txt

8. 同じ todo.txt が、緑と赤の 両方 に出ました。緑は add した「パン」まで、赤はそのあとに足した「バター」です。3つの場所の中身が、すべて違う状態です。

   $ git status
   On branch main
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	modified:   todo.txt
   
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   todo.txt
   

9. git commit が写真に撮るのは ステージの中身 です。作業ツリーの「バター」は入りません。

   $ git commit -m "パンを追加"
   [main c43e6a8] パンを追加
    1 file changed, 1 insertion(+)

10. 緑が消え、赤の「バター」だけが残りました。add していない変更は、コミットしても作業ツリーに残ったままです。

    $ git status
    On branch main
    Changes not staged for commit:
      (use "git add <file>..." to update what will be committed)
      (use "git restore <file>..." to discard changes in working directory)
    	modified:   todo.txt
    
    no changes added to commit (use "git add" and/or "git commit -a")

新しいファイルと git commit -am

1. 新しいファイル prices.txt を作ります。Git にとっては、まだ一度も add されていない 追跡外（Untracked）のファイルです。

   $ echo "牛乳は200円" > prices.txt

2. todo.txt にも1行足します。

   $ echo "パンを買う" >> todo.txt

3. todo.txt は modified、prices.txt は Untracked files の下に出ました。どちらも赤字ですが、意味が違います。追跡外のファイルは、ステージにも HEAD のコミットにも無いファイルです。

   $ git status
   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   todo.txt
   
   Untracked files:
     (use "git add <file>..." to include in what will be committed)
   	prices.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

4. -a は「追跡しているファイル の変更をまとめて add してからコミットする」オプションです。-am は -a と -m をまとめた書き方です。

   $ git commit -am "パンを追加"
   [main c43e6a8] パンを追加
    1 file changed, 1 insertion(+)

5. prices.txt は取り残されました。-am は追跡外のファイルを拾いません。新しいファイルは、一度は自分で add します。

   $ git status
   On branch main
   Untracked files:
     (use "git add <file>..." to include in what will be committed)
   	prices.txt
   
   nothing added to commit but untracked files present (use "git add" to track)

6. git add . の . は「今いるフォルダの中の全部」です。追跡外のファイルも含めて、変わったものをまとめてステージに写します。

   $ git add .

7. prices.txt が緑の new file になりました。ステージには入ったが、HEAD のコミットにはまだ無いファイルです。

   $ git status
   On branch main
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	new file:   prices.txt
   

8. prices.txt もコミットに入り、追跡されるファイルになりました。これ以降は -am でも変更を拾います。

   $ git commit -m "値段のメモを追加"
   [main d3c0aff] 値段のメモを追加
    1 file changed, 1 insertion(+)
    create mode 100644 prices.txt

9. コミットが2つ増えています。

   $ git log --oneline
   d3c0aff (HEAD -> main) 値段のメモを追加
   c43e6a8 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

git diff と git diff --cached

1. 買い物メモ todo.txt と、別のメモ notes.txt があるリポジトリです。git status は「どのファイルが変わったか」を見せます。git diff は「中身がどう変わったか」を見せます。

2. todo.txt に1行足します。

   $ echo "パンを買う" >> todo.txt

3. git diff は 作業ツリーとステージ を比べます。+ で始まる行が、足した行です。

   $ git diff
   diff --git a/todo.txt b/todo.txt
   --- a/todo.txt
   +++ b/todo.txt
   +パンを買う

4. git diff --cached は ステージと HEAD のコミット を比べます。まだ何も add していないので、何も出ません。

   $ git diff --cached

5. add すると、変更がステージに写ります。

   $ git add todo.txt

6. 今度は git diff が何も出さなくなりました。作業ツリーとステージが同じ中身になったからです。変更が消えたわけではありません。

   $ git diff

7. 変更は --cached の側に出ます。コミットする前に「何がコミットに入るか」を確かめるのは、こちらです。

   $ git diff --cached
   diff --git a/todo.txt b/todo.txt
   --- a/todo.txt
   +++ b/todo.txt
   +パンを買う

8. notes.txt にも1行足します。

   $ echo "特売は金曜も" >> notes.txt

9. --stat を付けると、中身の代わりに ファイルごとの変わった行数 だけが出ます。作業ツリーとステージの間で違うのは notes.txt だけです。

   $ git diff --stat
    notes.txt | 1 +
    1 file changed, 1 insertion(+)

10. notes.txt も add します。

    $ git add notes.txt

11. ステージ側の行数です。次のコミットに2つのファイルが入ることが、一覧で分かります。

    $ git diff --cached --stat
     notes.txt | 1 +
     todo.txt  | 1 +
     2 files changed, 2 insertions(+)

12. --name-only は、ファイル名だけを出します。Claude Code がコミットの直前によく打つ確認です。

    $ git diff --cached --name-only
    notes.txt
    todo.txt

13. 確かめた2つのファイルが、1つのコミットに入りました。

    $ git commit -m "パンと特売日を追加"
    [main 47dbb73] パンと特売日を追加
     2 files changed, 2 insertions(+)

git restore --staged（add の取り消し）

1. todo.txt に1行足します。

   $ echo "パンを買う" >> todo.txt

2. コミットするつもりのない下書き draft.txt も、同じフォルダにあるとします。

   $ echo "まだ下書き" > draft.txt

3. git add . は全部を拾うので、下書きまでステージに入ってしまいます。

   $ git add .

4. 緑の欄に draft.txt が new file として出ています。このままコミットすると、下書きも入ります。

   $ git status
   On branch main
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	new file:   draft.txt
   	modified:   todo.txt
   

5. git restore --staged は、ステージだけを HEAD のコミットの中身に戻す コマンドです。add の取り消しにあたります。作業ツリーの draft.txt には触りません。

   $ git restore --staged draft.txt

6. draft.txt は追跡外に戻りました。HEAD のコミットに無いファイルなので、ステージから外れたのです。

   $ git status
   On branch main
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	modified:   todo.txt
   
   Untracked files:
     (use "git add <file>..." to include in what will be committed)
   	draft.txt
   

7. ファイルの中身は残っています。消えたのは ステージに入っていた分 だけです。

   $ cat draft.txt
   まだ下書き

8. todo.txt だけがコミットされました。add したら status を見て、余計なものがあれば外す。これがコミット前の確認の流れです。

   $ git commit -m "パンを追加"
   [main c43e6a8] パンを追加
    1 file changed, 1 insertion(+)

ファイルを消してコミットする

1. 使わなくなった notes.txt を消します。rm はふつうのファイル削除なので、消えるのは 作業ツリーからだけ です。

   $ rm notes.txt

2. 赤字の deleted が出ました。「作業ツリーから消えたが、ステージにはまだある」という意味です。

   $ git status
   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	deleted:    notes.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

3. 削除も変更の1つです。- は消えた行を表します。

   $ git diff --stat
    notes.txt | 1 -
    1 file changed, 1 deletion(-)

4. 消したファイルの名前を add します。「消した」という変更をステージに写す、ということです。

   $ git add notes.txt

5. 緑の deleted になりました。次のコミットで notes.txt が無くなります。

   $ git status
   On branch main
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	deleted:    notes.txt
   

6. 新しいコミットには notes.txt がありません。それでも 前のコミットの写真には残っています。

   $ git commit -m "メモを消す"
   [main ebd4aa5] メモを消す
    1 file changed, 1 deletion(-)
    delete mode 100644 notes.txt

7. 3つの場所がまた同じ中身になりました。

   $ git status
   On branch main
   nothing to commit, working tree clean