git statusの見方｜Untracked等の意味と-s短縮表示の記号一覧

git status とは、作業中のファイルが「コミット予定」「変更したがまだ予定に入れていない」「Git がまだ追跡していない」のどれに当たるかを一覧で教えてくれるコマンドです。 ファイルの中身は何も書き換えないので、迷ったら何度打っても問題ありません。出力は英語ですが、見出しは実質3種類だけで、それぞれの下に「次に打つコマンド」がヒントとして書かれています。

この記事では、Git 2.43.0 で実際に動かした出力をそのまま貼りながら、3つの見出しの意味と次に打つコマンドの対応表、-s（短縮表示）の2文字記号の一覧、-sb と --porcelain の読み方を整理します。さらに、マージコンフリクト中・rebase 中・ahead / behind・detached HEAD といった「いつもと違う表示」も1つずつ再現して読み方を解説します。英語表示と日本語表示（Ubuntu 24.04 の日本語言語パック）の出力も並べています。

git status の見方 早見表

まず、通常表示（長い形式）に出てくる行と、その意味・次の一手です。

短縮表示（git status -s）でよく見る記号は次のとおりです。左の文字がステージ（インデックス）、右の文字が作業ツリーの状態を表します。

git status が見ている3つの場所

git status の出力を読むには、Git がファイルを置く「3つの場所」を知っておくと一気に楽になります。

flowchart LR
    U["Untracked files<br>(未追跡)"] -- "git add" --> S
    W["Changes not staged for commit<br>(作業ツリーの変更)"] -- "git add" --> S["Changes to be committed<br>(ステージ)"]
    S -- "git commit" --> H["HEAD<br>(コミット済み)"]
    S -- "git restore --staged" --> W
    H -- "git push" --> R["origin/main"]

git status は「作業ツリーとステージの差」「ステージと HEAD の差」「HEAD とリモート追跡ブランチの差」の3つを順に報告している、と覚えておくと、どの表示も同じ型で読めます。

通常表示の読み方｜3つの見出しの意味と次に打つコマンド

検証に使った状態

次のコマンドで、3つの見出しが同時に出る状態を作りました（Git 2.43.0、LANG=C.UTF-8）。

git init -q --bare remote.git
git clone -q remote.git work && cd work
printf 'a\n' > app.txt; printf 'r\n' > README.md
git add . && git commit -qm init && git push -q -u origin main

echo b >> app.txt              # 変更しただけ（未ステージ）
echo x >> README.md
git add README.md              # 変更してステージ
echo new > memo.txt            # 新しいファイル（未追跡）
git status

英語表示（実行結果）

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

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
    modified:   README.md

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:   app.txt

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

日本語表示（実行結果）

同じ状態を、Ubuntu 24.04 の日本語言語パック（language-pack-ja-base）のメッセージカタログを読み込ませ、LANG=ja_JP.UTF-8 で実行した結果です。

ブランチ main
Your branch is up to date with 'origin/main'.

コミット予定の変更点:
  (use "git restore --staged <file>..." to unstage)
    modified:   README.md

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:   app.txt

追跡されていないファイル:
  (use "git add <file>..." to include in what will be committed)
    memo.txt

日本語になる行と英語のままの行が混ざるのがわかります。今回確認した範囲では、Git 2.43.0 のソースに含まれる翻訳チーム一覧（po/TEAMS）に日本語はなく、日本語のメッセージは OS の言語パックなどが個別に用意しているものでした。そのため環境によって訳される範囲が変わります。英語の見出しをそのまま読めるようにしておくと、どの環境でも迷いません。

見出しごとの対応表（英語・日本語・次の一手）

「日本語の意味」の列は、上の実行結果に出た訳（コミット予定の変更点／追跡されていないファイル）と、英語のままだった行を筆者が訳したものです。

各ファイルの左に付くラベルの意味は次のとおりです。

かっこ内のヒントは「次のコマンド」そのもの

見出しのすぐ下にある (use "git ..." to ...) は、Git が出してくれる操作の案内です。

git restore <file> は編集内容を元に戻す操作で、戻した変更は取り出せません。 打つ前に git diff <file> で差分を確かめておくと落ち着いて進められます。

同じファイルが2つの見出しに出るとき

git add したあとで同じファイルをもう一度編集すると、1つのファイルが「Changes to be committed」と「Changes not staged for commit」の両方に出ます。次は、いろいろな変更を混ぜた状態の実行結果です。

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
    new file:   .gitignore
    modified:   README.md
    new file:   new.txt
    new file:   new2.txt
    deleted:    old.txt
    renamed:    name.txt -> renamed.txt
    new file:   tmp.txt

Changes not staged for commit:
  (use "git add/rm <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
    modified:   README.md
    modified:   app.txt
    modified:   new2.txt
    deleted:    tmp.txt

README.md はステージした時点の内容とその後に足した内容が別々に数えられています。このままコミットすると、入るのはステージした時点の内容だけです。後から足した分も入れたいときは、もう一度 git add README.md を打ちます。

何も変更がないとき・最初のコミット前

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

nothing to commit, working tree clean

working tree clean は「コミットしていない変更が1つもない」という意味です。git init した直後は次のように表示されます。

On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

Git の管理下にないフォルダで実行すると、次のメッセージになります。cd でリポジトリのフォルダへ移動してから打ち直しましょう。

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

git status -s の見方｜2文字記号の全パターン一覧

-s（--short）を付けると、1ファイル1行の短い形式になります。上と同じ状態で実行した結果です。

git status -s

M  README.md
 M app.txt
?? memo.txt

記号は「左＝ステージ」「右＝作業ツリー」

行頭の2文字は XY と呼ばれ、X（1文字目）がステージの状態、Y（2文字目）が作業ツリーの状態です。M と M は似ていますが、M がどちらの列にあるかで意味が変わります。

色付きの端末では、X の列が緑、Y の列と ?? が赤で表示されます（既定の配色）。

1文字ずつの意味

通常時の組み合わせ一覧（実行して確認したもの）

次の状態を作って git status -s --ignored を実行した結果です。

A  .gitignore
MM README.md
 M app.txt
A  new.txt
AM new2.txt
D  old.txt
R  name.txt -> renamed.txt
AD tmp.txt
?? memo.txt
!! debug.log

C（コピー）は今回の検証では再現していません（未実行）。公式ドキュメントの表では「インデックスでコピーされた」状態として載っています。

コンフリクト中の組み合わせ一覧（7種類すべて再現）

マージや rebase でコンフリクトが起きると、X と Y の両方に U・A・D が並ぶ特別な組み合わせになります。us は「いまいるブランチ側」、them は「取り込もうとしている側」です。

同じファイルを両方のブランチで別の名前に変え、さらに片方で削除・片方で編集したファイルを用意してマージした結果です。

CONFLICT (rename/rename): big.txt renamed to main-name.txt in HEAD and to side-name.txt in side.
CONFLICT (modify/delete): keep.txt deleted in HEAD and modified in side.  Version side of keep.txt left in tree.
Automatic merge failed; fix conflicts and then commit the result.

git status -s

DD big.txt
DU keep.txt
AU main-name.txt
UA side-name.txt

-sb と --porcelain の見方

git status -sb でブランチ情報も1行で見る

-b（--branch）を足すと、先頭に ## で始まるブランチ情報の行が付きます。

git status -sb

## main...origin/main
M  README.md
 M app.txt
?? memo.txt

## main...origin/main は「main ブランチが origin/main を追跡している」という意味です。未 push のコミットや未取得のコミットがあると、末尾に角かっこで表示されます。

毎回 -sb を付けるのが手間なら、設定で既定にできます。次は設定を一時的に与えて実行した結果です。

git -c status.short=true -c status.branch=true status

## main...origin/main [ahead 1]
 M app.txt
 M memo.txt

常に有効にするなら git config --global status.short true と git config --global status.branch true を設定します。通常表示に戻したいときは git status --long を使います。

git status --porcelain はスクリプト用

--porcelain は、Git のバージョンやユーザー設定が変わっても形式が変わらないことを約束した出力です。見た目は -s とほぼ同じですが、色が付かず、パスは常にリポジトリのルートからの表記になります。シェルスクリプトや CI から読むときはこちらを使います。

git status --porcelain

M  README.md
 M app.txt
?? memo.txt

「コミットしていない変更があるか」を判定するコピペ用の例です。

if [ -n "$(git status --porcelain)" ]; then
  echo "未コミットの変更があります"
else
  echo "作業ツリーはクリーンです"
fi

ファイル名に空白や改行が入る可能性があるときは、区切りを NUL 文字にする -z を組み合わせます。cat -v で見えるようにした実行結果です（^@ が NUL）。

git status -z | cat -v

M  README.md^@ M app.txt^@?? memo.txt^@

--porcelain=v2 はさらに詳しい

--porcelain=v2 --branch にすると、ブランチ情報が # で始まるヘッダーになり、各ファイルのモードやオブジェクト ID まで出力されます。

git status --porcelain=v2 --branch

# branch.oid 562807a2359ec3d2078bc994856e77c213233347
# branch.head main
# branch.upstream origin/main
# branch.ab +0 -0
1 M. N... 100644 100644 100644 4286f428e3b19fe84de503916ce0e7dc8deefea1 5b0cb7d0759ff618bafe41145e9fe9370c7812ee README.md
1 .M N... 100644 100644 100644 78981922613b2afb6025042ff6bd878ac1994e85 78981922613b2afb6025042ff6bd878ac1994e85 app.txt
? memo.txt

3つの形式の使い分け

ahead・behind・diverged の見方

ブランチ名の次の行は、手元のブランチとリモート追跡ブランチ（origin/main など）のコミット数の差を表します。

ahead（手元が進んでいる）

コミットしてまだ push していない状態です。

On branch main
Your branch is ahead of 'origin/main' by 1 commit.
  (use "git push" to publish your local commits)

nothing to commit, working tree clean

日本語表示では次のようになりました。

ブランチ main
このブランチは 'origin/main' よりも1コミット進んでいます。
  (use "git push" to publish your local commits)

behind（手元が遅れている）

別の人が push したあと、git fetch を実行した状態です。

On branch main
Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
  (use "git pull" to update your local branch)

nothing to commit, working tree clean

ブランチ main
このブランチは 'origin/main' に比べて1コミット遅れています。fast-forwardすることができます。

can be fast-forwarded は「手元に独自のコミットがないので、ブランチの位置を前へ進めるだけで追いつける」という意味です。

diverged（両方にコミットがある）

behind の状態で手元でもコミットすると、次の表示になります。

On branch main
Your branch and 'origin/main' have diverged,
and have 1 and 1 different commits each, respectively.
  (use "git pull" if you want to integrate the remote branch with yours)

nothing to commit, working tree clean

have 1 and 1 different commits は「手元だけに1つ、リモートだけに1つ」という順番です。-sb では [ahead 1, behind 1] と表示されます。履歴を一直線にまとめたいなら git pull --rebase、マージコミットを作るなら git pull --no-rebase を選びます。

「up to date」は fetch した時点の話

git status はリモートに問い合わせをしません。 比べている相手は、手元に保存されている「最後に fetch したときの origin/main」です。今回の検証でも、別のクローンから push した直後は次のように差が表示されず、git fetch を実行して初めて [behind 1] に変わりました。

## main...origin/main

git fetch
git status -sb

## main...origin/main [behind 1]

リモートの最新状況を知りたいときは、git fetch を打ってから git status の順にします。

追跡先がないブランチ

git switch -c nolink で作ったばかりのブランチには追跡先がないため、ahead / behind の行そのものが表示されません。

On branch nolink
nothing to commit, working tree clean

git push -u origin nolink で push すると追跡先が設定され、次回から差が表示されます。

マージコンフリクト中の git status の見方

main と feature の両方で app.txt の同じ行を変更し、git merge feature を実行しました。

Auto-merging app.txt
CONFLICT (content): Merge conflict in app.txt
Automatic merge failed; fix conflicts and then commit the result.

この直後の git status です。

On branch main
Your branch is ahead of 'origin/main' by 1 commit.
  (use "git push" to publish your local commits)

You have unmerged paths.
  (fix conflicts and run "git commit")
  (use "git merge --abort" to abort the merge)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
    both modified:   app.txt

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

git status -sb では次のように1行で表示されます。

## main...origin/main [ahead 1]
UU app.txt

ファイルを編集して git add app.txt を実行すると、表示が次のように変わります。

All conflicts fixed but you are still merging.
  (use "git commit" to conclude merge)

Changes to be committed:
    modified:   app.txt

All conflicts fixed but you are still merging. は「解決は終わったが、マージのコミットがまだ」という合図です。git commit を打てばマージが完了します。

削除と変更がぶつかった場合や、両方が同じ名前のファイルを追加した場合は、ラベルが変わります。

Unmerged paths:
  (use "git add/rm <file>..." as appropriate to mark resolution)
    deleted by them: README.md
    both added:      both.txt

deleted by them は「相手側が削除し、こちらは変更した」状態です。残すなら git add README.md、削除を受け入れるなら git rm README.md を選びます。

rebase 中の git status の見方

feature ブランチで git rebase main を実行し、コンフリクトで止まったときの git status です。

interactive rebase in progress; onto 2c15f49
Last command done (1 command done):
   pick 49305fd f
No commands remaining.
You are currently rebasing branch 'feature' on '2c15f49'.
  (fix conflicts and then run "git rebase --continue")
  (use "git rebase --skip" to skip this patch)
  (use "git rebase --abort" to check out the original branch)

Unmerged paths:
  (use "git restore --staged <file>..." to unstage)
  (use "git add <file>..." to mark resolution)
    both modified:   app.txt

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

-i を付けていなくても、Git 2.43.0 では interactive rebase in progress と表示されました。rebase 中は一時的にブランチから離れているため、git status -sb の1行目は次のようになります。

## HEAD (no branch)
UU app.txt

ファイルを直して git add app.txt を実行すると、ヒントが1行に変わります。

You are currently rebasing branch 'feature' on '2c15f49'.
  (all conflicts fixed: run "git rebase --continue")

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
    modified:   app.txt

日本語表示では、この行が「(全てのコンフリクトが修正されました: "git rebase --continue"を実行してください)」に対応します。git rebase --continue を実行すると rebase が完了し、次の表示に戻りました。

On branch feature
nothing to commit, working tree clean

マージ中は「git commit」で締め、rebase 中は「git rebase --continue」で締める、という違いを git status のヒントが毎回教えてくれます。

detached HEAD の git status の見方

git checkout HEAD~1 のように、ブランチ名ではなくコミットを直接指定して切り替えると、detached HEAD（ブランチから離れた状態）になります。

HEAD detached at 19470b9
nothing to commit, working tree clean

-sb では次のとおりです。

## HEAD (no branch)

この状態でコミットすると、1行目の at が from に変わりました。

HEAD detached from 19470b9
nothing to commit, working tree clean

from の状態でブランチに戻ると、Git は作ったコミットの残し方を案内してくれます。

Warning: you are leaving 1 commit behind, not connected to
any of your branches:

  b1b6906 det-commit

If you want to keep it by creating a new branch, this may be a good time
to do so with:

 git branch <new-branch-name> b1b6906

Switched to branch 'main'

過去の状態を見るだけなら detached HEAD のままで問題ありません。コミットを残したくなったら git switch -c でブランチを作ると覚えておけば十分です。

便利なオプションと設定

未追跡フォルダは -uall で中身まで表示

新しいフォルダを作ると、既定ではフォルダ名だけが表示されます。

git status -s

?? dir/
?? "\346\227\245\346\234\254\350\252\236.txt"

git status -s -uall

?? dir/a.txt
?? dir/sub/b.txt
?? "\346\227\245\346\234\254\350\252\236.txt"

日本語ファイル名が数字の並びになるとき

上の "\346\227\245..." は、日本語のファイル名（日本語.txt）がエスケープされた表示です。core.quotepath を false にすると、そのまま表示されます。

git -c core.quotepath=false status -s

?? dir/
?? 日本語.txt

常に有効にするには git config --global core.quotepath false を設定します。

stash の件数を確認する

git status --show-stash

nothing to commit, working tree clean
Your stash currently has 1 entry

迷いやすい表示と読み方

コミット前のチェックリスト

よくある質問

Q. Untracked files に出たファイルは、放っておいても大丈夫ですか？ A. はい、Git の履歴には入らないだけで、ファイルは手元にそのまま残ります。履歴に入れたいなら git add、ログや一時ファイルのように管理しないものなら .gitignore に書いておくと、一覧がすっきりして必要な変更を見つけやすくなります。

Q. Changes not staged for commit のままコミットするとどうなりますか？ A. その変更はコミットに入りません。コミットに入るのは「Changes to be committed」に並んでいるものだけです。追跡中のファイルの変更をまとめて入れたいときは git add -u、新規ファイルも含めるなら git add -A を使ってからコミットします。

Q. -s の「M 」と「 M」はどう見分ければよいですか？ A. M が行頭にあればステージ済み、1文字ぶん右にずれていれば未ステージです。色付きの端末なら、ステージ済みは緑、未ステージは赤で表示されるので、色でも見分けられます。

Q. git status を日本語で表示できますか？ A. 環境によります。今回 Ubuntu 24.04 の日本語言語パックで試したところ、「コミット予定の変更点:」「追跡されていないファイル:」など一部の行だけが日本語になりました。訳される範囲は環境ごとに違うため、この記事の対応表で英語の見出しを読めるようにしておくのがおすすめです。英語に固定したいときは LANG=C git status のように実行します。

まとめ

• git status は「作業ツリー・ステージ・HEAD・リモート追跡ブランチ」の差を順に報告している
• Changes to be committed はコミット予定、Changes not staged for commit は未ステージ、Untracked files は未追跡
• 見出しの下のかっこ書きが、次に打つコマンドの案内になっている
• -s の2文字は「左がステージ、右が作業ツリー」。?? は未追跡、UU はコンフリクト中
• -sb なら ahead / behind も1行でわかり、スクリプトには形式が固定の --porcelain を使う
• up to date は最後に fetch した時点との比較。最新を知りたいときは git fetch を先に打つ
• マージ中は git commit、rebase 中は git rebase --continue、detached HEAD は git switch で次へ進む

株式会社RJCでは、git status の読み方のような基礎を仲間と学び合っています。こうした知識を共有しながら、日々技術を磨いています。

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。