git status 是敲得最多、也最该先敲的一条命令:它告诉你当前在哪个分支、有哪些改动已暂存、哪些还没暂存、哪些文件根本没被跟踪。它只读不写,可以放心随时执行。

本文列出 git status 支持的常用参数与短格式状态码,帮你把「看状态」这件事从读一大段文字变成扫两列字母。

ℹ️
关于本系列
本文是《Git 使用教程》按命令拆分的第 4 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用 git status -h 看精简列表、git help status 看完整手册。示例以 Git 2.56.0 为准。

一、命令语法

先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。

bash语法
git status [<options>] [--] [<pathspec>...]

二、参数逐项详解

下表按用途列出 git status 的常用参数,每项都注明了「它到底改变了什么」。

参数作用
-s / --short紧凑格式,每行两字母状态码 + 路径
-b / --branch连当前分支与跟踪信息一起显示,常合并写成 git status -sb
--show-stash额外显示当前 stash 存档数量
--porcelain[=<版本>]输出稳定、不随用户配置与 Git 版本变化的格式,专供脚本解析
-u[<模式>] / --untracked-files未跟踪文件粒度:no 不显示、normal 显示目录、all 展开到每个文件;必须连写如 -uno
--ignored[=<模式>]把被 .gitignore 忽略的文件也列出来
-v / --verbose附带显示已暂存的 diff;写两次 -vv 连未暂存 diff 一起显示
--ahead-behind / --no-ahead-behind显示 / 不显示相对上游分支的领先落后计数
--renames / --no-renames强制开启 / 关闭重命名检测
-z用 NUL 代替换行分隔条目,解析含空格文件名时用
--column[=<选项>]把未跟踪文件按列排版
--long长格式,默认行为

短格式状态码怎么读

状态码含义
??未跟踪的新文件
M_ / _M已暂存的修改 / 未暂存的修改(_ 表示一个空格位)
A_ / D_新增到暂存区 / 从暂存区删除
R_重命名
UU合并冲突,两边都改了,需要先解决
!!被忽略的文件(仅在 --ignored 时出现)

三、常用示例

日常看状态

bash日常看状态
git status -sb
# ## main...origin/main [ahead 1]
# M  src/app.js        已暂存
#  M README.md         未暂存
# ?? notes.txt         未跟踪

排查「文件怎么没被加进去」

bash排查「文件怎么没被加进去」
git status --ignored -s | head -20
git check-ignore -v dist/app.js
git status -uno           # 大仓库里跳过未跟踪扫描,明显更快

脚本里用稳定格式

bash脚本里用稳定格式
git status --porcelain=v1 -z | tr "\0" "\n" | head
git branch --show-current

四、注意事项

ℹ️
两位状态码的位置含义
-s 输出的第一位 X 是暂存区相对 HEAD 的状态,第二位 Y 是工作区相对暂存区的状态。所以 MM 表示「改过、暂存了一部分、之后又改了」。
最值得养成的习惯: 每次 add / commit / switch / pull 之前先跑一次 git status -sb,能避开绝大多数「改错分支」「漏提交文件」的低级事故。

五、小结

git status 的参数几乎都在调「显示什么、显示多细」,不改变任何数据。把 -sb 变成肌肉记忆,再记住 --ignored 用于排查忽略规则、--porcelain 用于写脚本,这条命令就算吃透了。

本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git add 命令参数详解。