Git 初始提交执行 reset 时报 HEAD~1 无法识别

仓库刚完成第一次提交，想保留文件、撤回提交再换个分支，却在执行下面的命令时失败：

git reset --soft HEAD~1

fatal: ambiguous argument 'HEAD~1': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions

如果当前提交就是没有父提交的初始提交，HEAD~1 没有可指向的对象。加上 --、把 ~1 换成 ^，都不会凭空产生一个父提交。--soft 决定 reset 成功后的处理方式，不能让一个不存在的目标变得有效。

按实际目的选择处理方式：仅换分支名，可以保留提交；补文件或改首次提交内容，可以修订当前提交。下面针对本地新建仓库的这两种需求，不需要删除 Git 数据目录。

确认当前提交确实没有父提交

先在目标仓库读取状态：

git status --short --branch
git rev-parse --verify HEAD
git rev-parse --is-shallow-repository
git rev-list --parents -n 1 HEAD

第二条应返回当前提交的完整对象 ID。如果它也失败，可能还没有任何提交；此时不能把问题当成“撤销已有的第一次提交”，应先核对当前目录和仓库状态。

在非浅克隆仓库中，最后一条输出的第一个 ID 是当前提交，后面的 ID 才是父提交。只有一个 ID，表示没有父提交；有父提交时则应继续核对输入、对象是否可读等情况，不套用这里的根提交处理。

--is-shallow-repository 输出 true 时，本机可见历史可能被截断。CI 中深度为 1 的克隆也可能看起来只有一个提交，不能因此断定项目真的只有一次提交。需要历史的任务应先从正确远程补足历史，再重新判断；本文不把浅克隆边界当成真实的初始提交。

记录状态输出和当前提交 ID。若还有未提交文件，先另存一份工作目录内容，包括未跟踪文件。后面创建的备份分支只保存已提交的快照，不保存未提交改动。

例如，当前在 master，希望以后在 work/initial 上继续。以下名字都是示例，应选仓库中尚不存在的分支名。

保留原分支并创建新分支：

git checkout -b work/initial

新分支从当前提交开始，随后切换到它。第一次提交已经在新分支上，不需要先取消它再重新提交；原分支仍保留同一个提交。

如果你只想更改当前分支的名字，不需要留下原来的名字，可以改为执行：

git branch -m work/initial

这是两种选择，不要连续照抄。创建新分支与重命名都不应改变当前提交的 ID，也不应改变原有文件内容。使用小写 -m 可以在目标名称已存在时保留报错，不要为了让命令通过而直接换成强制覆盖选项。

核对分支名称与提交：

git status --short --branch
git rev-parse --verify HEAD

当前分支应是预期的新名字，提交 ID 应与操作前一致，未提交文件的状态也应一致。这些操作只处理本地分支，不会自动更改托管平台的默认分支或远程分支名称。

如果这次提交尚未发布给别人，可以直接修订它。先创建一个保留旧提交的本地分支，名字同样必须尚未存在：

git branch backup/initial-before-amend

修改需要调整的文件，再把明确需要的路径加入暂存区。下面的 path/to/changed-file 是占位路径，执行前换成真实文件；可按需列出多个路径。

git add -- path/to/changed-file
git diff --cached
git commit --amend --no-edit

提交前完整检查暂存区：已有的暂存改动也会进入这次修订，不能只看刚刚添加的那个文件。--amend 用新提交替换当前分支的末端提交，保留相同的父提交关系；对根提交来说，新提交仍没有父提交。--no-edit 沿用原来的提交说明。

若只是改提交说明，可以使用 git commit --amend 打开编辑器，但同样要先检查暂存区，避免顺带提交不相关文件。修订后旧提交仍由备份分支引用。

git rev-list --parents -n 1 HEAD
git diff backup/initial-before-amend HEAD --
git status --short --branch

对根提交，第一条仍应只有一个提交 ID。第二条显示修订前后已提交内容的差异，应恰好是预期修改。修改内容后会产生新的提交 ID；若只是反复提交完全相同的内容，不应单凭 ID 是否变化判断文件是否正确。

已经推送、供别人使用的提交，不要为了处理这个报错就改写并强推。可以把修正作为后续普通提交；确实需要改写共享历史时，要单独协调协作者与分支保护规则。

仅创建了新分支且没有继续提交时，可以切回原分支；仅做了重命名时，可以用 git branch -m 改回原名，前提是该名字仍可用。

修订提交后如果需要重新查看旧版本，先妥善保存新的未提交改动，再从备份分支建立另一个恢复分支：

git checkout -b recovery/initial backup/initial-before-amend

这样能检查旧快照，同时保留修订后的分支。若 Git 提示切换会覆盖本地改动，先处理这些文件，不要加 -f 强行切换。确认修订和恢复路径都不再需要前，保留备份分支。