git commit --amend 是 Git 中用于修改最后一次提交的核心命令

git commit --amend 是 Git 中用于修改最后一次提交的核心命令，常用于修正提交信息、补充遗漏文件，或合并暂存区修改到上一次提交（避免无意义的"修正xxx"提交）。

一、核心作用

修改最近一次的提交（包括提交信息、提交内容），本质是用新的提交替换旧的提交（会改变提交哈希值），因此已推送到远程的提交不建议 amend（会导致本地与远程历史不一致，需强制推送，协作场景慎用）。

二、常用场景 & 操作步骤

场景1：修正错误的提交信息

比如提交时写错备注（如把 fix: 修复登录bug 写成 fix: 修复登路bug），执行：

bash 复制代码

git commit --amend

会自动打开默认编辑器（如 Vim），修改提交信息后保存退出即可。
快捷写法（无需打开编辑器，直接修改）：
bash 复制代码
```
git commit --amend -m "正确的提交信息：fix: 修复登录bug"
```

场景2：补充遗漏的文件到上一次提交

比如提交后发现漏加了一个文件/修改，步骤：

先将遗漏的文件加入暂存区：

bash 复制代码

git add 遗漏的文件路径  # 比如 git add src/login.js

合并暂存区修改到上一次提交（保留原提交信息）：
bash 复制代码
```
git commit --amend --no-edit  # --no-edit 表示不修改提交信息
```

场景3：修改上一次提交的内容（替换文件）

比如提交后发现代码写错，想直接修正并覆盖上一次提交：

修改文件后，将修改加入暂存区：
bash 复制代码
```
git add 已修改的文件路径
```
覆盖上一次提交（可选择是否修改信息）：
bash 复制代码
```
git commit --amend  # 如需改信息则编辑，不改则加 --no-edit
```

三、关键参数说明

参数	作用
`-m "信息"`	直接指定新的提交信息，无需打开编辑器
`--no-edit`	保留原提交信息，仅修改提交内容（文件）
`--author`	修改提交的作者信息（如 `git commit --amend --author="张三 <zhangsan@xxx.com>"`）
`--date`	修改提交的时间（如 `git commit --amend --date="2025-12-12 10:00:00"`）

四、注意事项

仅修改本地未推送的提交 ：
如果提交已推送到远程（git push），再 amend 会导致本地历史与远程不一致，此时强制推送需谨慎：
bash 复制代码
```
git push -f  # 强制推送，协作场景下会覆盖远程历史，需提前告知团队成员
```

撤销 amend 操作 ：
如果 amend 后后悔，可通过 git reflog 找回旧提交：

bash 复制代码

git reflog  # 找到 amend 前的提交哈希（如 abc123）
git reset --hard abc123  # 恢复到旧提交

不要 amend 公共提交 ：
若提交已被团队其他成员拉取（pull），amend 后强制推送会导致他人本地历史冲突，建议用 git revert 撤销后重新提交。

五、示例：完整流程

bash 复制代码

# 1. 第一次提交（信息错误+漏文件）
git add src/xxx.js
git commit -m "feat: 新增登录功能"

# 2. 发现漏加 src/utils.js，且提交信息写错
git add src/utils.js  # 补充文件到暂存区

# 3. amend 修改：修正信息 + 合并漏加的文件
git commit --amend -m "feat: 完善登录功能（补充工具函数）"

# 4. 若未推送过，正常推送即可；若已推送（谨慎！）
git push -f origin 分支名