Gitの「changes not staged for commit」メッセージとは？意味と対処法をわかりやすく解説

Gitでコミットを作成する前に、変更したファイルをそのコミットに追加（ステージング）する必要があります。ファイルをコミットに追加する前にgit statusコマンドを実行すると、出力に「changes not staged for commit」というメッセージが表示されます。

この記事では、このメッセージの意味と重要性を解説し、コミットに追加したいファイルをステージングする具体的な手順を例とともに紹介します。

「changes not staged for commit」とは何か

Gitリポジトリ内のファイルは、大きく分けて「無視されている」「ステージングエリアにある」「コミットの一部になっている」の3つの状態のいずれかに分類されます。

無視（ignore）されたファイルは、Gitリポジトリの管理記録には含まれません。一方、ステージングエリアにあるファイルは、次回のコミットに追加される予定のファイルです。

ステージングエリアが重要なのは、どのファイルをコミットに含め、どのファイルを除外するかを自由に選択できるからです。コミットを作成する前であれば、いつでもステージングエリアへのファイルの追加や削除が可能です。

つまり、ステージングエリアは一種の「選別スペース」のようなものです。「あのファイルもコミットに含めるべきだった」と気づいたら、後からステージングに追加できます。すべての変更をステージングエリアに登録し終えたことを確認してから、コミットを作成すればよいのです。

具体例：メッセージが表示される場面

このメッセージが表示される状況を再現してみましょう。まず、Gitリポジトリ内のファイルを変更する必要があります。ここでは、空のREADME.mdファイルを含むリポジトリを想定し、その内容を以下のように書き換えます。

# Example Repo

ファイルを変更したら、次にgit statusコマンドを実行して、変更されたファイルの一覧を確認します。

git status

このコマンドの出力は以下のようになります。

On branch master
Your branch is up to date with 'origin/master'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

	modified:   README.md

この出力から読み取れる情報は次のとおりです。現在masterブランチ上にいて、ローカルブランチはリモートブランチ（origin/master）と最新の状態です。README.mdという1つのファイルが変更されていますが、このファイルはまだステージングエリアにもコミットにも追加されていません。つまり、作業ディレクトリに未ステージの変更が存在する状態です。

git addでファイルをステージングする

このメッセージを消すには、README.mdをステージングエリアに追加する必要があります。git addコマンドを使いましょう。

git add README.md

このコマンドにより、コミットに含めるファイルを個別に選択できます。続いて、ステージングエリアにある変更済みファイルを使ってコミットを作成します。git commitを実行してみましょう。

git commit -m "docs: Update README.md"

これで、ステージングエリアに追加したすべての変更を含む、リポジトリの現時点でのスナップショットが記録されます。リモートリポジトリと連携している場合は、コミット作成後にプッシュしておくとよいでしょう。

git push

これで、変更がローカルとリモートの両方のリポジトリに反映されました。

変更後の状態を確認する

最後に、もう一度git statusを実行して状態を確認してみます。

On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean

今度は「nothing to commit, working tree clean」と表示されました。これは、コミットにもステージングエリアにも追加されていない変更が存在しないことを意味します。リポジトリには、README.mdへの変更を含む新しいコミットが1件追加され、変更作業が正常に完了したことがわかります。

まとめ

「changes not staged for commit」メッセージは、git statusコマンドを実行した際に、変更済みだがまだステージングエリアに追加されていないファイルが存在する場合に表示されます。

重要なのは、これはエラーメッセージではなく、単なる通知であるという点です。ステージングエリアやコミットに含まれていない変更があることを教えてくれています。ファイルをgit addでステージングし、git commitでコミットすれば、このメッセージは消えます。

これで、プロの開発者のようにこのGitのメッセージに対応できる知識が身につきました。日々の開発でぜひ活用してください。