撤销修改与临时暂存

放弃未提交改动 vs 撤销已提交历史

在日常开发中，当我们发现某段代码写得不符合预期想要撤销时，我们不需要自己去记忆和输入复杂的恢复参数，直接用自然语言把要放弃或保留的范围清楚地告诉 Agent 即可。先让 Agent 检查当前未暂存、已暂存和已提交的代码状态，再按需选择恢复层级：

面对未提交的修改，我们有三种不同层级的恢复需求。如果我们刚写的代码逻辑混乱，且尚未执行 commit，就可以使用 restore 直接把文件还原成上一次提交时的样子。需要注意的是，丢弃未提交的修改是不可逆的，被覆盖的内容无法找回。这类具体的参数命令完全可以直接交给 Agent 处理，关键是把你的诉求用自然语言说清楚：

• 只放弃尚未暂存的改动：对 Agent 说“放弃购物车抽屉组件中尚未暂存的编辑，恢复到刚才暂存的状态”（底层对应 git restore <file>）。例如暂存区是 B，工作区改成了 C，执行后工作区恢复为 B。
• 只取消暂存、继续保留编辑：对 Agent 说“把购物车抽屉组件移出暂存区，但保留我对文件的最新修改”（底层对应 git restore --staged <file>）。
• 彻底退回最近一次提交：对 Agent 说“放弃购物车抽屉组件所有的未提交修改，彻底还原成最近一次提交时的样子”（底层对应把工作区与暂存区同时还原为 HEAD）。

第二种情况是代码已经生成了 Commit，甚至已经推送到远程仓库。此时如果我们直接用硬重置等暴力手段去抹除历史，会导致其他协作者无法正常同步。共享分支上通常选择反向提交（Revert）：自动新增一次提交，抵消指定提交引入的改动。例如上一次提交新增了两行代码，反向提交就会自动删掉这两行代码，既撤销了改动，又完整保留了操作历史。

你可以直接对 Agent 说：“帮我创建一个反向提交，撤销最近一次提交的修改。” Agent 底层执行的正是 git revert 命令（例如 git revert --no-edit HEAD）。撤销后，历史中会多出一行清晰的 Revert 记录，既安全又公开透明。

临时存放改动，或使用另一个工作目录

在实际开发中，经常会遇到这种情况：我们正在当前分支上编写某个功能，代码刚写了一半，尚未调试完毕，甚至还处于报错状态，无法生成一次完整的 Commit；此时突然需要紧急切换到另一个分支查看或修复问题。如果直接切换分支，这些未完成的改动可能会阻止切换，或者被错误地带到另一个分支造成混淆。

临时存放（Stash）↗ 可以把已跟踪文件的工作区和暂存区改动暂时收纳起来，让当前工作区恢复干净。但默认不包含未跟踪的新文件，需要一起保存新文件时，用 git stash push -u -m "购物车进行中"；-u 仍不包含被忽略的文件。它与 add 使用的暂存区是两回事。

用 git stash list 确认出现“购物车进行中”，再用 git status 核对剩余文件。在其他分支处理完工作并切回原分支后，运行 git stash pop 会取出最近一份收纳的改动，成功后自动移除记录；如果产生冲突，记录会保留，先解决冲突，不要反复 pop。需要尝试恢复原来的暂存状态时可用 git stash pop --index，但仍可能失败或冲突。

如果需要更彻底的隔离，例如同时让多个 AI Agent 在不同的分支上并行执行长时间任务，我们还可以使用 工作树↗ 能力。工作树允许在同一个代码仓库下，把不同的分支同时检出到本地不同的文件夹中。每个工作树有自己的工作区、暂存区和 HEAD，但共享仓库对象与分支引用。它不会自动安装依赖，也不会隔离端口、数据库或环境变量。

使用工作树时，直接对 Agent 说：“帮我在上级目录新建一个名为 shop-cart-fix 的独立工作树，基于 main 分支新建 fix/cart-copy 分支检出到那里，让我可以并行修复问题。”Agent 底层会执行 git worktree add 命令，并向我们反馈两个工作目录的路径。我们可以在新窗口打开该目录独立操作，互不干扰。

怎样向 AI 准确表达恢复范围

当代码出现问题需要撤销时，我们向 AI 下达的指令必须清晰严谨。如果含糊地要求 AI“帮我把刚才的改动退回去”，AI 有可能误用清空工作区或重置分支的危险命令，导致尚未保存的工作彻底丢失。

规范的表达应当指明要撤销的功能范围（例如说“购物车抽屉组件”），并明确说明是“只放弃未暂存的编辑，保留已暂存内容”，还是“创建一个反向提交来撤销指定历史记录”。在需要临时保留现场时，主动指示 AI 使用 stash 将改动存入临时栈中。

判断一下：新建了未跟踪的购物车文件，只运行默认 git stash，它会一起被存起来吗？ 不会。要包含它需明确使用 -u，之后通过 status 和 stash list 检查结果。