HOWTO · Git
如何使用 `git reset --soft`
了解 `git reset --soft` 如何将分支移至较早的提交,同时保留暂存更改,并学习如何验证结果和安全地继续操作。
本页内容
使用 git reset --soft <target> 将当前分支指针移到较早的提交,同时保持索引和工作区不变。因此,被移过的提交所引入的更改仍处于暂存状态,可以检查后再次提交。这样做适合合并最近的多个提交,或修改它们的提交说明,同时保留其内容。
git reset --soft 会更改什么
软重置会将当前分支的 HEAD 和分支指针移到你指定的提交。它不会更新暂存索引或工作区中的文件。因此,旧分支指针与目标提交之间的更改,相对于新的分支指针会处于暂存状态。该命令只影响当前检出的分支,不会移动所有指向旧提交的分支。
如果要移动历史记录,请务必指定目标。省略目标时,Git 会使用 HEAD,因此分支不会移动。已有的暂存或未暂存工作也会保留。之后请检查暂存差异,以确认后续提交具体会包含哪些内容。
选择要重置到的提交
使用 git log --oneline 查看最近的提交。选择应成为当前分支指针的提交,并在重置前核对其说明或哈希值。例如,HEAD~1 表示当前提交的第一父提交,也就是当前历史线上的前一个提交。HEAD~2 表示沿第一父链向后回溯两步。也可以用分支名、标签或提交哈希指定目标。
目标是要保留为分支指针的提交,而不是要删除的提交。重置到 HEAD~1 会让分支回退一个提交,并将原分支指针所指提交中的更改留在暂存区。如果历史并非线性,请在日志中核实目标,不要想当然地认为带数字的父提交表达式会选中你想要的提交。
重置提交并保留暂存更改
只重置一个提交时,先查看日志,然后运行 git reset --soft HEAD~1。要合并最近的多个提交,可以指定相应的较早目标,例如 git reset --soft HEAD~3。索引和工作区都会保留,因此这些提交中的更改可以合并在一起,用于创建新的提交。
运行以下示例:
本节中的代码以及显示的标签或输出仍为英文。
work_dir="$(mktemp -d)"
trap 'rm -rf "$work_dir"' EXIT
cd "$work_dir"
git init -q
git config user.name "Example User"
git config user.email "example@example.com"
printf 'first version\n' > note.txt
git add note.txt
git commit -qm "Add note"
printf 'second version\n' > note.txt
git commit -qam "Update note"
git reset --soft HEAD~1
git status --short
示例成功退出,并输出 M note.txt,这表明软重置后该更改仍处于暂存状态。
验证暂存的更改
重置后,使用 git status 确认预期文件已暂存。创建新提交之前,使用 git diff --cached 检查暂存补丁的具体内容。--cached 选项会比较索引与 HEAD;它现在就是选定的目标。如果显示的更改不是你预期的内容,请先暂停,检查目标和差异,再进行提交。
暂存补丁确认无误后,使用 git commit -m "Describe the combined change" 创建替代提交。如果要改写最近一次提交,则 git commit --amend 会替换它;确认前请仔细检查暂存内容和提交说明。软重置不会自动创建新提交,也不会修改提交说明。
--soft、--mixed 和 --hard 有何区别
这三种重置模式都会将当前分支指针移到目标,但它们对索引和工作区的处理方式不同:
git reset --soft <target>移动分支指针,同时保持索引和工作区不变。受影响的已提交更改仍处于暂存状态。git reset --mixed <target>移动分支指针,并将索引更新为与目标一致,同时保持工作区文件不变。被移过的提交中的更改会变为未暂存状态。未指定模式时,--mixed是默认模式。git reset --hard <target>移动分支指针,并使索引及已跟踪的工作区文件都与目标一致。不在目标中的已跟踪文件编辑可能会被丢弃,因此只有在确实需要这种结果时才使用它。
重置模式通常会保留无关的未跟踪文件。不过,如果某个未跟踪文件或目录阻碍写入目标中的已跟踪路径,git reset --hard 可能会将其删除。如果你需要让更改保持暂存状态以便创建替代提交,请选择 --soft;如果你希望先以未暂存状态检查这些更改,请选择 --mixed。不要用 --hard 代替软重置。
如何安全地使用 git reset --soft
软重置适合编辑最近的本地历史记录,例如将多个提交合并为一个,或准备将其中的更改放入另一个提交。运行前,使用 git status 和 git log --oneline 确认当前分支和目标。运行后,在提交之前检查 git status 和 git diff --cached,以免误将无关的暂存工作一并提交。
如果这些提交已经共享给他人,移动分支会改写其他人可能已据此开展工作的历史记录。更改共享历史前应先协调;如果要撤销已公开的更改并保留历史记录,通常更适合使用 revert。软重置只会更改本地仓库,直到你之后推送为止;但推送改写后的历史可能会影响协作者。请明确目标和暂存差异,避免把强制推送作为例行后续操作。