AI 编程教程中文版
官方教程中文版Help Center 与排障

AI 功能排障总览

把 Agent、Ask、Plan、Debug、Tab、Inline Edit 的官方入口整理成模式选择、验证和排障路径。

📖 本篇术语速查表
英文 / 缩写中文一句话解释
AI 功能排障ai triage定位补全 / Agent 不工作的问题。
功能开关toggle功能是否启用、配置是否对。
模型连通connectivity到模型的连接是否正常。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你排查 Cursor 的 AI 功能（Tab / Agent）不工作的问题。

你是 Cursor AI 功能排障顾问。

【角色】
Cursor AI 功能排障顾问，按分层定位、一次只改一个变量的原则帮我找根因。

【输入】
- 哪个功能不工作（Tab / Agent / 其它）：___
- 现象（无响应 / 报错 / 结果差）：___
- 最近改过什么：___
- 网络 / 登录是否正常：___

【工作流程】
1. 确认功能开关和配置
2. 检查登录和模型连通
3. 区分是配置、连接还是用法问题
4. 给修复和验证

【输出规范】
▌一、功能开关 / 配置确认
▌二、登录 / 连通检查
▌三、问题归类
▌四、修复 + 验证

【硬约束】
- 一次只改一个变量
- 区分功能没开和真故障
- 凭据相关问题不暴露明文
- 不要替我臆测原因或编造不存在的设置，信息不全先问清
- 不确定的机制或报错一律以官方文档为准，禁止照搬过时写法
- 给的每条结论都要落到具体可照做的步骤或示例，不停留在「建议」「考虑一下」这类没法直接执行的空泛表述

Cursor 的 AI 功能很多，但排障时先不要问“哪个功能坏了”，而要先判断用户当前在做什么：要改代码、读代码、先出方案、还是调复杂 bug。

核验日期：2026-05-06。Agent、Ask、Plan、Debug、Tab、Inline Edit 的入口、快捷键和能力会随 Cursor 版本变化；支持文档按官方 Help Center 复核。

1. 一句话判断

大多数“Cursor 不好用”其实是模式选择错了：要改代码用 Agent，要只读理解用 Ask，要先审方案用 Plan，要带运行证据查 bug 用 Debug，要补全正在写的局部代码用 Tab。

先选对模式，再看上下文、索引、权限、网络、模型用量和项目规则。

2. 模式选择

Agent

Agent 是默认主力。官方说明它能搜索代码库、编辑多个文件、运行终端命令，并自行修复错误。

适合：

  • 新功能。
  • 重构。
  • 修 bug。
  • 写测试。
  • 根据错误输出继续验证。

入口：

  • Mac：Cmd + I。
  • Windows / Linux：Ctrl + I。

Agent 编辑会进入 diff view。出错时可用 Stop 中断，或对历史消息使用 Restore Checkpoint 回滚。

Ask

Ask 适合只读理解：解释架构、追踪调用链、定位文件、理解错误背景。不要用 Ask 期待它直接改代码。

Plan

Plan 适合跨文件或高风险任务。先让 Cursor 产出方案，确认影响范围、步骤和验证方式，再允许执行。

Debug

Debug 适合有 runtime evidence 的问题，例如报错、日志、失败测试、浏览器异常。给 Debug 的输入要包含复现路径和错误输出。

Tab

Tab 是 AI autocomplete。它基于最近编辑、周围代码和 linter errors 给出灰色建议。

常用操作：

  • 接受完整建议：Tab。
  • 拒绝：Escape 或继续输入。
  • 逐词接受：Mac 用 Cmd + Right；Windows / Linux 用 Ctrl + Right。
  • 接受后再次按 Tab，可 jump-in-file 到预测的下一个编辑位置。
  • 可在右下角 Tab status indicator 暂停、全局关闭或按扩展名关闭。

Inline Edit

Inline Edit 适合对当前选中区域做局部修改，不适合让它承担跨文件任务。

3. AI 功能排障顺序

按这个顺序排：

  1. 模式：是否用错 Agent / Ask / Plan / Debug / Tab。
  2. 上下文：是否打开正确 folder，是否用 @file / @folder 指定了关键文件。
  3. 索引：codebase indexing 是否完成或需要 reindex。
  4. 规则：Rules、AGENTS.md、CLAUDE.md 是否误导了 Agent。
  5. 权限：终端命令、文件读取、MCP、浏览器工具是否被拒绝。
  6. 网络：streaming、代理、SSL inspection 是否影响响应。
  7. 模型与用量：模型是否可用、是否达到 limit、是否被企业策略限制。

4. 给 Agent 的任务格式

一个可执行请求应该包含：

  • 目标：要改什么。
  • 范围：哪些文件或模块。
  • 约束：不要改什么，必须保留什么。
  • 验证：跑什么测试、看哪个页面、检查什么日志。
  • 回退：失败后如何撤回。

坏请求：

“优化一下项目。”

好请求：

“在登录页增加邮箱格式校验，只改 src/auth 和登录表单组件。完成后跑现有表单测试，并列出 diff 里新增的校验分支。”

5. 商业级验收

  • 用户知道 Agent / Ask / Plan / Debug / Tab 的边界。
  • Agent 任务能产生可审查 diff。
  • 高风险改动先用 Plan。
  • 复杂 bug 用 Debug，并提供日志或复现步骤。
  • Tab 能被接受、拒绝、暂停和按文件类型关闭。
  • 失败时能 Stop、Restore Checkpoint 或回退 diff。
  • 模式问题、上下文问题、网络问题、模型用量问题能分开排查。

6. 常见失败点

  • 用 Ask 提需求，期待它自动改文件。
  • 用 Agent 问大范围问题，没有指定文件、约束和验证。
  • Tab 频繁干扰但不知道从 status indicator 关闭。
  • 把模型 limit、网络 streaming 或企业权限问题误判为功能 bug。
  • 切换任务不新开 chat，导致旧上下文污染。

官方来源

接下来去哪

继续下一页

102-customization-help

Agent 工作流

继续看 Agent 如何读写和验证

模式理解篇

把各模式放进真实开发流程

安装和第一个项目排障

按官方 Help Center 把 Cursor 安装、登录、打开项目、首个 Agent 任务和迁移问题整理成可执行排障路径。

自定义与上下文排障

把 Rules、Context、MCP、Skills、Indexing、Ignore files 变成可排查的 Cursor 上下文治理路径。

本页目录

1. 一句话判断2. 模式选择AgentAskPlanDebugTabInline Edit3. AI 功能排障顺序4. 给 Agent 的任务格式5. 商业级验收6. 常见失败点官方来源接下来去哪