レッスン一覧 › Lesson 03
ステージングを使いこなす
add の取り消し、変更の破棄、.gitignore。「まだコミットしていない変更」を自在に扱えるようになります。
難易度: 入門 ・ 所要時間: 約 12 分 ・ 学ぶコマンド: restore / add / .gitignore / commit -a
このページはブラウザ上のターミナルで実際にコマンドを打ちながら進めるレッスンです(JavaScript を有効にしてください)。手順は次のとおりです。
STEP 1: プロジェクトを確認する
今回は最初から 3 つのファイルと 3 つのコミットがある状態です。
ls
git log --onelineREADME.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.cssgit 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.csscat 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 statusUntracked として出てきます。これを無視するには、.gitignore というファイルに無視したいパターンを書きます。
echo "*.log" > .gitignore
git statusdebug.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 + commit | git commit -am "msg" |
| 記録しないファイルを決める | .gitignore に書く |
restore は 2 種類ある ことを覚えておいてください。--staged 付きは安全(中身は消えない)、なしは危険(中身が消える)です。
次のレッスンでは、積み重なった履歴の読み方を学びます。
関連する解説
- 3 つのエリア — ワークツリー・ステージ・リポジトリ。add と commit の意味が腑に落ちる。
次のレッスン: 履歴を読む