git status

実行前の状態

README.md を 1 回コミットしたあと、README.md に 1 行足し、新しく app.py を作った場面です。どのファイルが変わり、どれが次のコミットに入るのかを確かめたいときに打ちます。

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

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
echo "print('hi')" > app.py

最小の例と結果

git status

On branch main
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   README.md

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	app.py

no changes added to commit (use "git add" and/or "git commit -a")

• On branch main は、いま main ブランチにいるという意味です。
• Changes not staged for commit の下は、変えたけれど、まだ add していないファイルです。README.md がここに出ます。
• Untracked files の下は、Git がまだ一度も記録していないファイルです。新しく作った app.py がここに出ます。

成功の確認

出てきたファイル名が、自分で変えたファイルと合っていれば読めています。短く見たいときは -s を付けます。

git status -s

 M README.md
?? app.py

左の 2 文字が状態です。1 文字めはステージ (次のコミットに入れる物) の状態、2 文字めは作業中のファイルの状態を表します。M は変更、?? はまだ記録していないファイルです。

構文と主要オプション

失敗時の戻し方

git status は読むだけのコマンドです。ファイルの中身もコミットも変えないので、戻す操作はありません。

よく出るのは、リポジトリの外で打ったときの次のエラーです。

git status

fatal: not a git repository (or any of the parent directories): .git

cd でリポジトリのフォルダへ移ってから打ち直します。git init は新しいリポジトリを作るコマンドなので、すでにあるリポジトリの外で打ち直しには使いません。

よくある疑問

関連

• いまの状態を確かめる (status と diff) 受講生向けのレッスン
• 変更を記録する (add と commit) 受講生向けのレッスン
• クラウドエディター受講生向けの、ブラウザで開く開発環境
• git add 変更を次のコミットに入れる