官方教程中文版Help Center 与排障
帮助与排障
帮助与排障相关的 Cursor 官方教程中文版。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 帮助与排障 | help & triage | 各类问题的排查入口。 |
| 按现象定位 | by symptom | 从问题现象反查该看哪篇。 |
| 分层排查 | layered | 按环境 / 配置 / 用法分层。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按问题现象快速定位该看 Cursor 哪篇排障。
你是 Cursor 排障导航顾问。
【角色】
Cursor 排障导航顾问，按分层定位、一次只改一个变量的原则帮我找根因。
【输入】
- 我遇到的问题现象：___
- 涉及的方面（安装 / 功能 / 模型 / 安全 / 账号 / 性能）：___
- 最近的变化：___
- 紧迫程度：___
【工作流程】
1. 把现象归到对应排障类别
2. 指向该看的排障篇
3. 给通用的分层排查起点
4. 提示需官方支持的情况
【输出规范】
▌一、现象归类
▌二、对应排障篇
▌三、分层排查起点
▌四、何时找官方支持
【硬约束】
- 一次只改一个变量定位根因
- 拿不准的保守处理
- 敏感信息不暴露
- 不要替我臆测原因或编造不存在的设置，信息不全先问清
- 不确定的机制或报错一律以官方文档为准，禁止照搬过时写法当 Cursor 行为和预期不一致时，先分层定位：账号、网络、项目索引、模型用量、工具权限、编辑器状态还是云端任务。这一组是 Cursor 的排障层——Help Center、故障页、网络页、Agent Tab、账号计费和模型用量页用来定位真实问题。
阅读方式：先看判断和路径，再进入具体章节。Cursor 的资料变化很快，模型、价格、用量和企业策略以官方页面为准。
安装和第一个项目排障
Help Center 中的安装、第一项目、迁移入口。
AI Features Help
Agent、Ask、Plan、Debug、Tab、Inline Edit 等功能入口。
Customization Help
Rules、Context、MCP、Skills、Indexing、Ignore files。
Models and Usage Help
模型、API keys、usage limits、token rate。
Security and Privacy Help
隐私、区域、合规、SSO、Marketplace security。
Account and Billing Help
账单、发票、超额、支付、取消和退款。
Agent、Tab、网络和性能排障
常见 Agent、Tab、安装、网络、扩展和性能问题。
排障顺序
Cursor 出问题时，不要直接重装。先按层定位：
- 账号和计费：是否登录、是否有用量、是否触发 limits。
- 网络：企业代理、VPN、防火墙、DNS 是否拦截。
- 项目索引：
.cursorignore、.gitignore、semantic search、Reindex 是否影响文件发现。 - Agent 上下文：prompt 是否具体，是否使用 Plan Mode，是否用
@file指定文件。 - 工具权限：terminal、browser、MCP、extensions 是否被限制。
- 云端任务：Cloud Agent、Bugbot、Slack 或 GitHub 是否选错 repo/branch。
- 性能：远程连接、本地资源、扩展冲突和缓存。
这个顺序能避免把网络问题误判成模型问题，也能避免把 .cursorignore 导致的上下文缺失误判成 Agent “不聪明”。
官方排障要点
官方 Help Center 里有几个高频事实：
- Agent 准确性依赖具体 prompt、Plan Mode、Rules 和
@文件上下文。 - Agent 找不到文件时，先查
.cursorignore和.gitignore，再 Reindex 或直接 attach 文件。 - Agent 修改可以用 Restore Checkpoint 回退，但 checkpoint 是本地机制，不能替代 git。
- Agent terminal 默认可能带
CI=1，如果项目行为受影响，可以在命令前 unset。 - 企业代理或 VPN 拦截 HTTP/2 时，可以在 Network 设置里启用 HTTP Compatibility Mode 到 HTTP/1.1。
- 防火墙环境要 allowlist Cursor 相关域名。
- Remote SSH 场景下 AI 请求通常从本机发出，不是从远端主机发出。
这些都是排障时应该先确认的事实，不要靠猜。
提交问题的材料
如果要向团队或官方求助，至少收集：
- Cursor 版本和系统信息。
- Request ID 或相关任务 ID。
- 复现步骤。
- 期望行为和实际行为。
- 是否使用代理、VPN、Remote SSH、WSL 或企业网络。
- 相关
.cursorignore、Rules、MCP、terminal command。 - 已经尝试过的操作，例如 Reindex、HTTP/1.1 compatibility、restart。
材料越结构化，越容易判断是账号、网络、索引、Agent、工具还是云端任务问题。
不建议的做法
- 一出错就重装编辑器。
- 把所有规则删掉再试，导致真实边界丢失。
- 把企业代理绕开，用个人网络验证生产项目。
- 不看 Request ID 就把错误描述成“AI 不工作”。
- 没保留失败命令和日志就让 Agent 修自己。
排障页的目标是缩小问题面，而不是列所有可能原因。