必须启用Agent模式才能让Cursor自动修改代码，否则AI仅输出建议；启动后通过选中代码+Ctrl+K、呼出聊天框+上下文锚点或指定路径等方式提交指令，再逐行审阅确认修改。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在已有项目中让Cursor自动修改代码，而不是手动一行行改，必须启用Agent模式并正确提供上下文，否则AI只会生成建议而不会真正写入文件。
启动Agent模式并确认工作状态
按 Ctrl+.（Windows/Linux）或 ⌘.（macOS）激活Agent模式；右下角∞图标变为蓝色且显示“Agent”即表示已就位。
注意：Normal模式下AI只输出代码片段，不会自动修改文件——这是最常被忽略的前提，【未切换到Agent模式就提交指令，AI绝不会动你本地代码】。
若左下角显示的是Plan、Debug或Ask，请点击∞图标手动选中Agent。
让AI精准修改指定位置的代码
方法一：用鼠标选中要改的代码块 → 按 Ctrl+K（Win）或 Cmd+K（Mac）→ 输入自然语言指令，例如：“把这里HTTP状态码判断改成枚举方式，保留原有逻辑” → 回车。
方法二：不选中任何代码 → 直接按 Ctrl+L 呼出聊天框 → 输入带上下文锚点的指令，例如：“@UserService.java 把 login 方法里的密码明文校验替换成 BCryptPasswordEncoder.matches()”。
方法三：在指令中强制指定文件路径 → 输入 “Refactor @src/main/java/com/example/auth/LoginController.java:45-62，提取表单验证逻辑为独立方法 validateLoginRequest()”。
审阅与确认AI修改结果
第一步：查看右侧Files面板，它会列出AI本次修改涉及的所有文件及增删行数，例如：+17 -9 表示新增17行、删除9行。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
第二步：逐个点击文件名展开差异对比，绿色为新增内容，红色为将被删除的内容，灰色为未变动上下文。
第三步：对每处修改做决策——点击某行左侧的√接受该行，×拒绝该行；或点击文件右侧的√一次性接受整个文件改动。
第四步：检查右上角按钮——Keep All 会直接写入全部变更，Undo All 会彻底回滚，逐行审阅 是唯一能局部接受/拒绝的方式。
这一步不能跳过：Agent模式虽能自动执行，但AI可能误读业务逻辑，【一旦点击 Keep All，所有改动立即覆盖原文件，不可无痕恢复】。
处理AI修改失败或报错
当AI生成代码后自动运行失败（如编译错误、测试不通过），Agent会尝试自我修复——它会重新读取错误日志，调整代码，再次运行，最多循环5次。
若仍失败，Files面板顶部会出现红色提示条：“Agent failed after 5 retries”，此时需人工介入：点击提示条旁的“Show Plan”查看AI的修复思路，再手动微调原始指令。
常见失败原因：未提供足够上下文（比如没加@引用）、项目缺少必要依赖（如AI调用Lombok但pom.xml未声明）、或指令存在歧义（如“优化性能”未说明具体瓶颈）。
