git commit

実行前の状態

README.md を 1 回コミットしたあと、README.md に 1 行足し、それを git add でステージに載せた場面です。この変更を、説明を付けて履歴に残したいときに打ちます。

この状態を手元で作るなら、次の順に打ちます。

git init -q -b main hello
cd hello
echo "# hello" > README.md
git add README.md
git commit -q -m "README を作る"
echo "start" >> README.md
git add README.md

最小の例と結果

-m の後ろに、何をしたかを短く書きます。

git commit -m "README に説明を足す"

[main a1b2c3d] README に説明を足す
 1 file changed, 1 insertion(+)

• main はコミットしたブランチ、a1b2c3d はこのコミットの番号 (ハッシュ) です。番号はコミットごとに違うので、手元では別の英数字が出ます。
• 1 file changed, 1 insertion(+) は、1 つのファイルで 1 行増えたという意味です。

成功の確認

履歴の一番上に、いま書いたメッセージがあれば記録されています。

git log --oneline

a1b2c3d README に説明を足す
9f8e7d6 README を作る

git status

On branch main
nothing to commit, working tree clean

nothing to commit, working tree clean は、記録していない変更が 1 つも残っていないという意味です。

構文と主要オプション

失敗時の戻し方

戻し方は、そのコミットをもう push したかどうかで変わります。GitHub などとつないであれば、git fetch のあとに git status を打ちます。Your branch is ahead と出たら、まだ push していないコミットがあります。

まだ push していないとき

メッセージを直したいなら、直前のコミットを作り直します。元のコミットは置き換わり、番号も変わります。そのときステージに載っている変更も一緒に入るので、git status でステージが空なのを確かめてから打ちます。

git commit --amend -m "README に使い方を足す"

入れ忘れたファイルがあるなら、add してから作り直します。--no-edit はメッセージをそのまま使う指定です。

git add 忘れたファイル
git commit --amend --no-edit

コミットそのものを取り消したいなら、次のように打ちます。消えるのはコミットの記録だけで、変更はステージに載ったまま残ります。HEAD~1 は 1 つ前のコミットを指すので、リポジトリの最初のコミットには使えません。

git reset --soft HEAD~1

もう push したとき

push したコミットを作り直したり消したりすると、ほかの人の手元の履歴と食い違います。代わりに、打ち消すコミットを新しく足します。元のコミットも履歴に残ります。

git revert a1b2c3d

git reset --hard は、作業中のファイルの変更まで消します。消した変更は戻せないことが多いので、ここでは使いません。

よくある疑問

関連

• 変更を記録する (add と commit) 受講生向けのレッスン
• 良いコミットメッセージの書き方受講生向けのレッスン
• 直前のコミットを直す (commit --amend) 受講生向けのレッスン
• クラウドエディター受講生向けの、ブラウザで開く開発環境
• git add 変更をステージに載せる
• git status いまの状態を見る