这一节汇总了日常开发中最常遇到的 AI 功能异常现象，按“表现 → 原因 → 处理”三步快速定位。
1. AI 对话无响应或长时间转圈
- 排查方向：先确认网络连通性（Cursor 服务需访问海外节点）；再观察当前选中的是否为高级模型（如 Claude 3.5 Sonnet），免费版额度耗尽后会进入 Slow Request 队列，甚至超时。
- 快速处理：点击侧边栏模型下拉框，临时切换到 GPT-4o 或基础模型测试。若切换后立刻恢复，说明是原模型服务波动或额度问题；若全部模型都无响应，检查系统代理或公司防火墙设置。
2. 行内补全（Cursor Tab）不触发
- 排查方向：确认设置中 "Cursor Tab" 开关处于启用状态（见 2.3.1）；当前文件是否过大（超过数千行）或被识别为纯文本（如
.log、.txt），导致上下文被截断；是否误按了Esc关闭了当前会话的补全。 - 快速处理：尝试按
Ctrl + Space（手动触发 IntelliSense/补全）强制唤起；若文件确实过长，可临时折叠无关代码块，或将大文件拆分为模块。
3. 代码生成质量突然下降 / 答非所问
- 排查方向：检查当前对话上下文是否已累积过长（超过几十轮），模型出现“遗忘”；或者免费账号因额度策略被默默切换到了轻量级模型。
- 快速处理：点击对话面板顶部的 "+" 新开窗口，重置上下文后重新提问；同时确认当前模型名称显示的是否为你预期的高级模型（见 2.3.2）。
4. @ 指令引用异常（找不到文件或内容偏差）
- 排查方向：项目首次打开时，Cursor 需要建立代码库索引，大型仓库可能耗时数分钟；文件路径包含中文、空格或特殊符号时，偶尔会导致
@文件解析失败；被引用的文件处于.gitignore或项目工作区外。 - 快速处理：等待左下角索引状态图标消失后再试；改用相对路径或直接选中代码片段，按
Ctrl/Cmd + K进行“选中代码定向对话”（见 3.1.2），绕过路径解析问题。
5. Agent 模式中断、报错或误改无关文件
- 排查方向：Agent 在执行多步骤任务时，若某一步终端命令返回错误，或生成的代码块过长被截断，会陷入暂停；提示词不够具体时，AI 可能扩大修改范围。
- 快速处理：对话底部通常会出现 "Continue" 或 "Retry" 按钮，点击让 Agent 继续；若它改了不该动的文件，立即用
Ctrl/Cmd + Z回退，并在下一轮指令中明确限定范围，例如“仅修改src/utils.js，不要碰其他文件”。重要操作前务必先提交 Git（见 3.5.3）。
6. 快捷键失效或与插件冲突
- 排查方向：从 VS Code 同步过来的插件可能占用了
Ctrl/Cmd + K、Ctrl/Cmd + L等 AI 核心快捷键；输入法（如搜狗、微信输入法）的全局快捷键也会拦截组合键。 - 快速处理：进入 "文件 → 首选项 → 键盘快捷方式"，搜索 "Cursor" 查看是否有冲突提示；暂时禁用可疑插件排查。若仅在某语言文件下失效，检查该语言扩展是否覆盖了默认键位。