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

レッスン一覧 › Lesson 03

ステージングを使いこなす

add の取り消し、変更の破棄、.gitignore。「まだコミットしていない変更」を自在に扱えるようになります。

難易度: 入門 ・ 所要時間: 約 12 分 ・ 学ぶコマンド: restore / add / .gitignore / commit -a

このページはブラウザ上のターミナルで実際にコマンドを打ちながら進めるレッスンです(JavaScript を有効にしてください)。手順は次のとおりです。

STEP 1: プロジェクトを確認する

今回は最初から 3 つのファイルと 3 つのコミットがある状態です。

ls
git log --oneline

README.md、app.js、style.css があります。まずは git status で「きれい」な状態であることを確認しましょう。

STEP 2: 間違えて add してしまった!

2 つのファイルを変更して、うっかり両方 add してしまう状況を作ります。

echo "// TODO" >> app.js
echo "/* TODO */" >> style.css
git add .

git status を見ると両方とも緑(ステージ済み)になっています。でも本当は app.js だけをコミットしたかった、とします。

STEP 3: ステージから降ろす(restore --staged)

ステージに載せた変更を降ろすには git restore --staged を使います。ファイルの中身は変わらず、「次のコミットに含めるかどうか」だけが戻ります。

git restore --staged style.css

git status を打つと、app.js は緑(ステージ済み)、style.css は赤(変更あり・未ステージ)になります。

git status の出力にも (use "git restore --staged <file>..." to unstage) と書いてあります。Git は次に何をすればよいかを教えてくれることが多いので、メッセージを読む習慣をつけましょう。

STEP 4: app.js だけコミットする

git commit -m "app.js に TODO コメントを追加"

コミット後も style.css の変更はワークツリーに残っています。

STEP 5: 変更そのものを捨てる(restore)

style.css の変更は、やっぱり要らなかったことにします。ワークツリーの変更を破棄 するには git restore を使います。

git restore style.css

cat style.css で TODO の行が消えていることを確認してください。

⚠️ これは元に戻せない操作です。本物の Git でも、まだコミットしていない変更は restore で完全に消えます。実行前に git diff で中身を確認するクセをつけましょう。

STEP 6: add と commit を一度に(commit -a)

すでに追跡しているファイルの変更なら、-a オプションで add を省略できます。

echo "  color: #333;" >> style.css
git commit -am "文字色を設定"

-am は -a(追跡済みファイルを全部ステージ)と -m(メッセージ)を合わせたものです。

ただし 新しいファイル(Untracked)は -a では含まれません。新規ファイルは必ず git add が必要です。

STEP 7: 記録したくないファイル(.gitignore)

ログやビルド成果物など、Git に記録したくないファイルもあります。試しに作ってみましょう。

echo "error log..." > debug.log
git status

Untracked として出てきます。これを無視するには、.gitignore というファイルに無視したいパターンを書きます。

echo "*.log" > .gitignore
git status

debug.log が表示されなくなり、代わりに .gitignore 自体が Untracked として出てきます。.gitignore はチームで共有するものなので、これはコミットします。

STEP 8: .gitignore をコミットする

git add .gitignore
git commit -m ".gitignore を追加"

これで debug.log は今後ずっと無視されます。git add . を打っても含まれません。

まとめ

このレッスンでやったこと

やりたいことコマンド
ステージから降ろす(中身はそのまま)git restore --staged <file>
ワークツリーの変更を捨てる(⚠️戻せない)git restore <file>
追跡済みファイルをまとめて add + commitgit commit -am "msg"
記録しないファイルを決める.gitignore に書く

restore は 2 種類ある ことを覚えておいてください。--staged 付きは安全(中身は消えない)、なしは危険(中身が消える)です。

次のレッスンでは、積み重なった履歴の読み方を学びます。

関連する解説

  • 3 つのエリア — ワークツリー・ステージ・リポジトリ。add と commit の意味が腑に落ちる。

次のレッスン: 履歴を読む