git commit 把暂存区里的清单固化成一个提交对象,并让当前分支的 HEAD 前进一步。它只影响本地仓库,不会传到远端——这一点决定了「还没 push 之前,一切都还来得及改」。
本文列出 git commit 支持的常用参数并逐个解说,重点是 --amend、-a、--fixup 的正确用法和边界。
关于本系列
本文是《Git 使用教程》按命令拆分的第 6 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用
git commit -h 看精简列表、git help commit 看完整手册。示例以 Git 2.56.0 为准。一、命令语法
先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。
bash语法
git commit [<options>] [--] [<pathspec>...]
二、参数逐项详解
下表按用途列出 git commit 的常用参数,每项都注明了「它到底改变了什么」。
| 参数 | 作用 |
|---|---|
-m <信息> / --message | 直接给提交信息;可写多个 -m 拼成标题与正文 |
-F <文件> / --file | 从文件读提交信息,-F - 从标准输入读 |
-a / --all | 自动暂存已跟踪文件的修改与删除再提交;新文件仍需先 add |
--amend | 用当前暂存内容重做上一次提交(会生成新的提交对象) |
--no-edit | 配合 --amend,沿用原提交信息不再打开编辑器 |
--fixup=<commit> / --squash=<commit> | 生成待合并的修正提交,供之后 rebase -i --autosquash 自动归并 |
-p / --patch | 交互式挑选 hunk 直接提交,跳过手动 add |
-v / --verbose | 在编辑器底部附上 diff,方便边看边写提交信息 |
--allow-empty | 允许无改动的空提交,CI 触发占位时用 |
-s / --signoff | 在信息末尾追加 Signed-off-by 行 |
-C <commit> / -c <commit> | 复用另一次提交的信息(不改 / 可再编辑) |
--author=<串> / --date=<串> | 覆盖作者 / 提交日期 |
--no-verify | 跳过 pre-commit、commit-msg 等钩子;部分版本可用短写 -n |
--dry-run | 预演,不生成提交 |
-S[<keyid>] / --gpg-sign | 对提交做 GPG 签名 |
三、常用示例
日常提交
bash日常提交
git add -A
git commit -m "feat: 增加登录限流"
git commit -am "fix: 修正空指针" # 等价于 add -u + commit -m
补文件、改信息
bash补文件、改信息
git add README.md
git commit --amend --no-edit # 补进上一次提交,信息不变
git commit --amend -m "docs: 补安装说明"
多段信息与预演
bash多段信息与预演
git commit -m "fix: 修复订单重复提交" -m "原因是按钮未做防抖,加锁后复测通过。"
git commit --dry-run
git commit --allow-empty -m "chore: 触发 CI 构建"
四、注意事项
--amend 不是「修改」而是「替换」
--amend 会生成一个全新的提交对象并把分支指过去,原来的提交变成悬空对象。已经 push 给别人的提交再 amend,会造成历史分叉并逼所有人处理强推。只对自己本地、尚未公开的提交使用。别把 --no-verify 写进别名: 它会跳过格式检查、lint、单测等 pre-commit 钩子。另外注意
git commit -n 在不少版本里是 --no-verify 的短写,不是 --dry-run;真要预演请写完整的 --dry-run。五、小结
日常真正高频的只有 -m、-am、--amend --no-edit 三个;--fixup 和 --squash 属于为后续整理历史埋钩子,第二轮讲 rebase -i 时会用到。写清楚提交信息,比记住所有参数更值钱。
本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git diff 命令参数详解。