Cursor Agent 改错代码时，可在该次对话的时间线上找到改动前的 Checkpoint，先预览文件，再用 Restore Checkpoint 将文件恢复到那个时间点。它只回退文件，不删除聊天消息；Checkpoint 保存在本机，适合撤销 Agent 改动，长期版本记录仍应交给 Git。
回退前先确认要保留的修改
先暂停继续让 Agent 改文件，查看当前 Source Control 差异，记下哪些文件是 Agent 改的、哪些是你后来手动补的。如果后续手动修改也要保留，先复制到安全位置或做一次 Git 提交，再执行恢复。Restore 的目标是某个时间点的文件状态；不要在没有看预览的情况下把整段工作一起退掉。
在 Agent 对话中恢复到改动前
- 打开产生错误改动的 Agent 对话，在时间线上找到错误改动之前的 Checkpoint。
- 点击该 Checkpoint，预览当时的文件状态，并与当前差异核对：确认目标文件、改动范围以及你希望保留的手动修改。
- 确认后执行恢复。此前的请求上也可能有 Restore Checkpoint 按钮；将鼠标移到消息上时，还可通过 + 按钮进入相关操作。具体位置以当前 Cursor 界面显示为准。
- 恢复后重新查看 Source Control 差异，打开出错文件检查关键代码，运行项目原有的相关测试或启动验证。
Cursor 官方 Checkpoints 文档说明，Agent 会在重要修改前自动建立本地快照；点时间线中的 Checkpoint 可以预览，再恢复到该状态。文档同时强调恢复只改变文件，不清除对话消息。
Checkpoint 与 Git 分别解决什么问题
Checkpoint 用来撤销这次 Agent 会话中的改动，Git 用来保存可追踪、可共享的长期版本。官方明确说 Checkpoint 与 Git 分开保存，且只应用于撤销 Agent 改动；如果要回到昨天的提交、比较多人协作的版本或保存一个可交付节点，应检查 Git 历史，而不是把本地 Checkpoint 当作备份系统。
如果时间线里找不到合适的 Checkpoint，先检查 Git 历史和当前未提交差异，再决定要恢复哪些文件。不要凭“上一步”猜测所有代码都能被一次撤回，尤其不要直接覆盖后来由自己或同事写入的内容。
本文依据 2026 年 10 月 1 日读取的官方文档整理，未在读者的 Cursor 版本与仓库中实测。恢复前先看预览并保护要保留的改动；恢复后以实际文件差异和项目测试结果确认是否回到了目标状态。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/30069.html
