フリーキーズ | 独学プログラミング

git commitコマンドの使い方と意味を理解しよう!初心者向け解説

リンドくん

リンドくん

たなべ先生、git commitって何ですか?いつも使ってるけど、正直よく分かってなくて...

たなべ

たなべ

絶対覚えておきたいコマンドだね!
git commitは変更履歴を記録する大切なコマンドなんだ。言わば「セーブポイント」のようなものだよ。

今日はその仕組みと正しい使い方をしっかり解説するね。

git commitとは?その本質的な役割

git commitは、プロジェクトの変更履歴を永続的に記録するためのコマンドです。
簡単に言えば、あなたがコードに加えた変更を「保存」するような役割を果たします。ただし、通常のファイル保存とは異なり、変更の履歴も一緒に管理してくれるのが特徴です。

このコマンドの本質的な役割は、以下の3つです。

  • 変更をスナップショットとして記録する = 特定の時点のプロジェクト状態を保存
  • 変更理由を残す = コミットメッセージで何をなぜ変更したのかを記録
  • バージョン履歴を構築する = 複数のコミットが積み重なって開発履歴になる

特にチーム開発では、これらの役割が非常に重要です。
誰がいつ何の目的で変更を加えたのか、その情報がきちんと記録されていれば、後からコードを見直したときに「なぜこの変更が加えられたのか」という文脈が理解しやすくなります。

基本的な使い方

リンドくん

リンドくん

でも、ただ単に「git commit」って打つだけでいいんですか?

たなべ

たなべ

実はそれだけだとうまく動かないんだよ。コミットするときには「メッセージ」が必要なんだ。
これは将来の自分や他の開発者に向けた説明書きのようなものだね。

git commitの基本的な使い方は以下の通りです。

git commit -m "コミットメッセージ"

ここで「-m」はメッセージを指定するオプションです。
コミットメッセージは、あなたが加えた変更の内容を簡潔に説明するものです。

使用例

例えば、ログイン機能を実装した場合は以下のように書きます。

git commit -m "ユーザーログイン機能を実装"

バグを修正した場合はこちらのように書きましょう。

git commit -m "パスワードリセット時のエラーを修正"

このようにメッセージを具体的に書くことで、後から見返したときに「何をしたコミットなのか」がすぐにわかります。

ステージングとコミットの関係

覚えておきたいのは、git commitは「ステージング」されたファイルのみをコミットするという点です。
ステージングとは、コミットする変更を選択する作業のことです。

通常のワークフローは以下のようになります。

  1. ファイルを変更する
  2. git add コマンドでステージングエリアに追加する
  3. git commit コマンドでステージングしたファイルをコミットする
# 変更したファイルをステージング
git add index.html

# ステージングしたファイルをコミット
git commit -m "トップページのデザインを更新"

効果的なコミットメッセージの書き方

リンドくん

リンドくん

コミットメッセージって何を書けばいいんですか?
「変更しました」だと駄目ですか?

たなべ

たなべ

それだと将来の自分が困ることになるよ!
良いコミットメッセージは「何を」「なぜ」変更したかが分かるものなんだ。具体的な例を見てみよう。

効果的なコミットメッセージは、プロジェクトの履歴を理解しやすくするためにとても重要です。
以下のポイントを心がけましょう。

1. 簡潔で具体的に書く

  • 良い例:「ログインフォームのバリデーション機能を追加」
  • 悪い例:「更新」「修正しました」

2. 命令形で書く

英語の場合は特に、現在形の命令文で書くのが慣例です。

  • 良い例:「Add validation to login form」(ログインフォームにバリデーションを追加する)
  • 悪い例:「Added validation」(バリデーションを追加した)

3. 変更理由も含める

「なぜ」その変更を行ったのかも記録しておくと、後々非常に役立ちます。

  • 良い例:「ヘッダーの配色を変更(アクセシビリティ向上のため)」
  • 悪い例:「ヘッダーを変更」

4. プレフィックスを使う

チーム開発では、コミットの種類を示すプレフィックスを付けることも効果的です。

  • feat、またはfeature = 新機能
  • fix = バグ修正
  • docs = ドキュメント変更
  • style = フォーマットの変更(コードの動作に影響しない変更)
  • refactor = リファクタリング
git commit -m "feature: ユーザー登録機能を実装"
git commit -m "fix: パスワードリセットのバグを修正"

これらのルールを守ることで、プロジェクトの変更履歴が整理され、チーム開発がスムーズになります。
整理された履歴は後からの機能追加やバグ修正の際に非常に役立ちます。

便利なオプションと応用テクニック

リンドくん

リンドくん

gitを使いこなしている人って、なにか特別なオプションとか使ってるんですか?

たなべ

たなべ

そうだね、実は知っているかどうかで作業効率が全然違うオプションがいくつかあるんだ。
特に -a--amend は覚えておくと便利だよ!

git commitには、作業を効率化するための様々なオプションがあります。
よく使われるものをいくつか紹介します。

-a (--all) オプション

git addgit commit を一度に行うオプションです。
新規ファイルは対象外で、既に追跡されているファイルの変更のみが対象になります。

git commit -a -m "全ての変更ファイルをコミット"

これは、以下の2つのコマンドを一度に実行するのと同じです。

git add -u
git commit -m "全ての変更ファイルをコミット"

--amend オプション

直前のコミットを修正するためのオプションです。
コミットメッセージの変更や、コミットし忘れたファイルの追加に使えます。

# 直前のコミットメッセージを変更
git commit --amend -m "新しいコミットメッセージ"

# ファイルを追加して直前のコミットを修正
git add 忘れたファイル
git commit --amend

これは、小さなミスを修正するのに非常に便利です。
ただし、既にプッシュしたコミットに対して使用すると、履歴が書き換わるため注意が必要です。

-v (--verbose) オプション

コミットメッセージを書く際に、どのような変更を行ったかをエディタ内に表示してくれるオプションです。

git commit -v

これにより、コミットメッセージを書きながら変更内容を確認できるので、より適切なメッセージを書けるようになります。

空のコミット

コメントだけのコミットを作成することもできます。
これはCIパイプラインのトリガーやマイルストーンの記録に便利です。

git commit --allow-empty -m "バージョン1.0.0リリース準備完了"

これらのオプションを適切に使いこなすことで、gitでの作業がより効率的になります。
最初は基本的な使い方だけで構いませんが、徐々にこれらのオプションも試してみると良いでしょう。

コミットの確認と履歴の見方

リンドくん

リンドくん

コミットしたあとに、ちゃんと記録されているか確認する方法はありますか?

たなべ

たなべ

もちろん!
git logコマンドを使えば、これまでのコミット履歴をすべて見ることができるよ。
特に --oneline オプションを使うと見やすくなるから、先生はよく使ってるんだ。

コミットした後、その結果を確認するためのコマンドがいくつかあります。

git logコマンド

コミット履歴を表示する最も基本的なコマンドです。

git log

これを実行すると、最新のコミットから順に表示されます。
各コミットについて以下の情報が表示されます。

  • コミットハッシュ(一意の識別子)
  • 作者の名前とメールアドレス
  • コミット日時
  • コミットメッセージ

見やすくする --onelineオプション

git log --oneline

このオプションを使うと、各コミットが1行で表示され、全体の流れが把握しやすくなります。

a7f3a6c ユーザー登録機能を実装
3c8d9e1 ログインページのデザインを修正
5b2f7d0 プロジェクト初期設定

グラフィカルに表示する --graphオプション

ブランチの分岐や統合を視覚的に確認したい場合は、--graphオプションが便利です。

git log --oneline --graph

これにより、ブランチの構造がアスキーアートで表示され、開発の流れが理解しやすくなります。

特定ファイルの履歴を見る

特定のファイルに関するコミット履歴だけを見たい場合は、ファイル名を指定します。

git log -- ファイル名
git log -- src/login.js

コミットの詳細を確認する

特定のコミットの変更内容を詳しく見たい場合は、git showコマンドを使います。

git show コミットハッシュ
git show a7f3a6c

これらのコマンドを使いこなすことで、プロジェクトの変更履歴を効率的に追跡できます。
特に複数人で開発している場合は、誰がどのような変更を加えたのかを確認する機会が多くなりますので、ぜひ覚えておきましょう。

まとめ

リンドくん

リンドくん

なるほど!コミットって単なる保存じゃなくて、プロジェクトの歴史を作っていくんですね!

たなべ

たなべ

その通り!
良いコミット習慣を身につけることは、プロフェッショナルなエンジニアへの第一歩だよ。今日学んだことを実践してみてね。

git commitは単なる変更の保存ではなく、プロジェクトの「歴史書」を書いていく作業です。
適切なコミット習慣は、以下のような大きなメリットをもたらします。

  • トラブル時の原因特定が容易になる
  • チームメンバーとの協業がスムーズになる
  • プロジェクトの進捗や変更理由が明確になる

プログラミングの学習過程で、これらのgitの使い方を身につけることは非常に重要です。
現代のエンジニアにとって、バージョン管理の基本スキルは必須といえるでしょう。

ぜひ実際のプロジェクトで今日学んだことを実践してみてください。
最初は慣れるまで時間がかかるかもしれませんが、良いコミット習慣を身につければ、将来の自分や他の開発者から感謝されることでしょう。

関連するコンテンツ