Cursor 使用指南

Cursor 是 Anysphere 推出的AI 原生代码编辑器（VS Code 分支），主打“智能体驱动开发”，支持多模型切换、全代码库理解与自主任务执行，适合个人与团队提效。

一、主要功能

• 智能代码补全（Tab）上下文感知：实时预测并生成代码片段。
• 无限次 Tab：支持连续补全代码逻辑。
• AI 指令编辑（Cmd+K）自然语言生成：快速生成/修改代码、重构、写测试、查 bug。
• 多文件支持：支持单文件与多文件同时编辑。
• 智能体模式（Agent）自主规划：具备自主规划、编码、运行、调试能力。
• 跨文件协作：可跨文件、调用终端、自动修复错误。
• 代码库索引与语义搜索理解整个代码库结构与依赖关系。
• 精准定位逻辑，支持全局语义检索。
• 多模型支持内置模型包括 GPT-5.5、Claude Opus 4.7、Gemini 3.1 Pro 等。
• 支持一键切换最优模型。
• 团队协作与集成生态集成：支持 Slack、GitHub、Jira 集成。
• 企业功能：团队管理、SSO、审计日志（商业版）。
• Composer 2.5自然语言驱动的多文件编辑引擎。
• 支持 / 命令、@ 文件引用、! 终端执行。

二、适用人群

• 初学者/学生用自然语言学习编程，降低语法门槛。
• 快速搭建项目原型。
• 全栈/独立开发者大幅提升开发速度。
• 单人完成小团队工作量，原型与迭代高效。
• 资深工程师/架构师处理重复工作（测试、迁移、重构）。
• 专注架构与核心业务逻辑。
• 小团队/创业公司低成本提升研发效率。
• 支持多人协作与代码审查。
• 企业/财富 500 强安全规模化加速开发。
• 支持私有部署、企业级安全与合规。

三、免费与付费情况

1. 免费版（Hobby）

• 价格：$0。
• 试用权益：新用户自动获得 14 天 Pro 全功能试用。
• 配额限制：
• 2000 次/月 Tab 补全。
• 50 次/月慢速高级模型调用。
• 功能限制：无团队功能，部分顶级模型不可用，适合轻度体验与学习。

2. 专业版（Pro）

• 价格：$20/月，年付 $192（省 20%）。
• 学生优惠：凭 .edu 邮箱可 免费 1 年 Pro。
• 配额权益：
• 无限 Tab 补全。
• 500 次/月快速高级请求。
• 无限慢速请求。
• 额外权益：全模型访问、优先响应、多文件编辑、无水印。

3. 商业版（Business）

• 价格：$40/用户/月，年付省 20%。
• 核心权益：
• 包含全 Pro 功能。
• 组织级隐私模式。
• 集中账单、管理员仪表盘。
• 支持 SAML/OIDC SSO、优先支持。

4. 企业版（Enterprise）

• 价格：定制，需联系销售。
• 核心权益：
• 私有部署。
• 专属模型。
• 定制集成。
• 高级安全与合规支持。

四、如何使用（快速上手）

1. 下载安装

• 官网链接：https://cursor.com/cn
• 系统支持：macOS / Windows / Linux。
• 网络环境：国内可直接访问，无需翻墙。

2. 注册登录

• 注册方式：邮箱注册。
• 快捷登录：支持 Google / GitHub。
• 新手福利：新用户自动获得 14 天 Pro 试用。

3. 核心快捷键（必记）

快捷键功能备注Tab接受代码补全建议常用Cmd+K (Mac) / Ctrl+K (Win)AI 指令生成/修改代码核心功能Shift+TabPlan 模式（先规划再编码）推荐复杂任务Cmd+I打开 Chat 面板对话式开发

4. 智能体使用流程（推荐）

1. 进入 Plan 模式：按 Shift+Tab。
2. 输入需求：例如“实现用户登录接口，含密码加密与错误处理”。
3. 审核计划：AI 分析项目并生成带文件路径的实施计划，人工审核/修改计划。
4. 执行任务：确认后切换 Agent 模式，AI 自动执行、提交、测试、修复。

5. 模型选择建议

• 简单任务：用 GPT-5.5 Fast。
• 复杂逻辑：用 Claude Opus 4.7。
• 长文本处理：用 Gemini 3.1 Pro。

五、避坑点（新手必看）

• 谨慎使用 Agent风险：直接做复杂任务易逻辑漂移、漏改文件、依赖冲突。
• 建议：优先使用 Plan 模式，审核计划后再执行。
• 注意免费额度风险：免费版额度有限，重度开发 50 次慢速请求会很快用完，响应变慢、模型降级。
• 建议：重度开发必升 Pro。
• 代码必须人工审查风险：AI 可能写出边界错误、安全漏洞（如无 WHERE 的 UPDATE）、性能问题。
• 建议：核心逻辑、数据库操作、正则务必自测。
• 提示词要具体坏提示：“写登录功能”。
• 好提示：“用 Node.js+Express 实现登录接口，密码 BCrypt 加密，JWT 会话，返回用户信息（不含密码），错误码 401/403/500"。
• 版本控制习惯建议：小步提交，频繁 Git Commit。
• 补救：每次功能完成即提交，Agent 改乱后可快速回退；配合 Continue and revert 更稳。
• 插件管理建议：部分 VS Code 插件（如微软 C++）更新后会冲突。
• 操作：锁定稳定版，关闭自动更新。
• Agent 卡住处理原因：超时或上下文过大。
• 处理：拆分大任务、换简单请求测试、重试对话、重启 Cursor；避免一次性输入超大上下文。