Cursor 官方教程中文版
按 Cursor 官方 Docs、Help Center、CLI 和企业文档重组的中文查询手册。
这一部分不是逐字翻译,而是把 Cursor 官方资料按中文开发者常见问题重组。每页都保留官方来源,方便你回到原始事实核验。
阅读方式:先看判断和路径,再进入具体章节。Cursor 的资料变化很快,模型、价格、用量和企业策略以官方页面为准。
入门与账号
入口层。先确认 Cursor 是什么、怎么安装、怎么迁移、模型和价格怎么核验,再进入 Agent 工作流。
Agent 工作流
执行层。Cursor Agent 把 instructions、tools、model 和 checkpoints 组合成一个可规划、可执行、可回退的编码循环。
上下文与定制
上下文层。Rules、MCP、Skills、Subagents、Hooks、Commands 和 Plugins 决定 Agent 能看见什么、遵守什么、什么时候自动触发。
CLI 与自动化
自动化层。Cursor CLI 把编辑器里的 Agent 工作流带到终端、脚本和 CI 场景。
云端 Agent
异步执行层。Cloud Agents(原 Background Agents)、Bugbot、review 和远端入口适合把长任务从本机切到云端继续跑。
集成、API 与 SDK
扩展层。Slack、GitHub、Linear、Admin API、Dashboard API、Marketplace 和 deeplinks 把 Cursor 接进外部系统。
团队与企业治理
治理层。Team、Enterprise、SSO、SCIM、成员管理、隐私、analytics 和 billing groups 决定组织怎么安全扩展 Cursor。
帮助与排障
排障层。Help Center、故障页、网络页、Agent Tab、账号计费和模型用量页用来定位真实问题。
总体学习路径
这套官方教程中文版按“从个人使用到团队治理”组织:
- 入门与账号:先跑通低风险项目。
- Agent 工作流:把一次编码任务做成可规划、可执行、可回退的循环。
- 上下文与定制:把 Rules、MCP、Skills、Subagents、Hooks 变成稳定上下文。
- CLI 与自动化:把 Agent 能力带到终端、脚本和 CI。
- 云端 Agent:把长任务、PR、issue 和异步协作放到云端执行。
- 集成、API 与 SDK:接入 GitHub、Slack、Linear、Admin API、SDK 和 Deep Links。
- 团队与企业治理:处理身份、权限、隐私、网络、模型、成本、审计。
- 帮助与排障:按账号、网络、索引、Agent、工具、云端任务分层定位问题。
这个顺序能避免直接从高级能力开始。Cursor 的能力很多,但商业项目更关心可控、可验证、可审计。
使用原则
- 查事实:回官方来源。
- 做任务:先读 Agent 工作流。
- 反复提醒:写进 Rules 或 Skills。
- 接外部系统:先做权限和网络审查。
- 团队上线:先做 SSO、成员、隐私、用量和审计。
- 出问题:按排障层分诊,不要直接重装。
所有高波动内容,例如模型、价格、用量、企业策略和功能命名,都应回 Cursor 官方页面核验。
质量标准
每篇官方教程页都应该保留三层信息:官方事实、中文使用判断、真实项目验收。只有官方事实会变成手册,只有判断会变成随笔;二者结合,才适合作为教程。
如何回查来源
Cursor 官方资料分散在 Docs、Help Center、llms.txt、dashboard 入口和企业文档中。本站页面只承接稳定事实和中文结构,遇到这些内容必须回官方确认:
- 模型、价格、usage pools、Max Mode 和 billing。
- GitHub、Slack、Linear、Cloud Agent、Bugbot 的权限和触发语法。
- Team、Enterprise、SSO、SCIM、Privacy Mode、audit logs、service accounts。
- 网络 allowlist、proxy、HTTP compatibility、remote connection。
- SDK public beta、API 变更、Deep Links 限制。
如果官方入口和站内教程冲突,以官方入口为准,再回本站修正文案。教程站不能替代官方状态页、dashboard 或合同条款。
更新边界
维护这组教程时,优先更新会改变真实操作的内容,例如权限、配置、命令、API、触发方式、排障步骤和验收标准。只影响营销文案、截图位置、按钮名称轻微变化的内容,可以等下一轮集中维护。