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