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 命令参数详解。