版本控制与协作 / 知识点

Git 命令速查手册

手册条目

CODE
git commit -m "<提交说明>"

将暂存区中的修改保存为新的本地提交。

提交暂存内容

使用 git commit 将暂存区当前保存的修改生成一个新的本地提交。它只提交已经通过 git add 暂存的内容,不会自动包含工作区中的未暂存修改。

基本语法

常用写法是 git commit -m "<提交说明>"。执行前先检查暂存区,避免漏提交文件或混入无关修改。

bash
git status --short
git diff --cached --stat
git commit -m "fix: handle empty username"
git log -1 --oneline

预期输出如下,分支名、提交 ID 和文件统计会随仓库实际情况变化。

text
M  src/user.js
 src/user.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
[<BRANCH> <ID>] fix: handle empty username
 1 file changed, 2 insertions(+), 1 deletion(-)
<ID> fix: handle empty username

M src/user.js 中的 M 位于第一列,表示该文件的修改已经暂存。最后一行说明当前分支最新提交已更新为 <ID>。

常用参数

  • -m "说明":直接在命令行填写提交说明,适合单行信息。
  • --dry-run:预览哪些内容会被提交,不创建提交。
  • --amend:用当前暂存内容替换最近一次提交,并生成新的提交 ID。
  • -v:打开编辑器编写说明时,同时显示待提交差异,便于复核。

高频用法

提交前使用 git diff --cached 查看完整差异;只看文件和行数统计时使用 git diff --cached --stat。提交完成后,可用 git show --stat --oneline -1 检查最新提交包含的文件。

需要分批提交时,先用 git add <PATH> 精确暂存本次相关文件,再执行 git commit。不要为了省事把所有修改一次性加入暂存区。

风险与边界

git commit 只创建本地提交,不会自动上传远程仓库;需要共享时还要执行 git push。

当暂存区为空时,命令会提示 nothing to commit,不会创建空提交。若确实需要空提交,应明确使用 --allow-empty,不要把它用于普通业务修改。

对已经推送并被他人使用的提交执行 --amend 会改变提交 ID,后续通常需要强制推送,并可能导致他人的分支出现冲突。安全做法是创建一个新的修正提交;只有确认提交尚未共享时才修改历史。

排障清单

  • 出现 Author identity unknown:配置 Git 的 user.name 和 user.email 后重试。
  • 提交内容少了文件:用 git status --short 检查该文件是否仍显示为第二列修改或 ??。
  • 提交混入无关内容:尚未推送时可撤销最近提交并重新暂存;已经推送时优先用新的反向提交修正。
  • 提交被钩子拒绝:阅读钩子输出并修复检查失败项,不要默认使用 --no-verify 绕过质量检查。

速查:先看 git diff --cached,确认无误后再执行 git commit -m "说明"。

目录与阅读设置

记录一个想法

Git 命令速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通