Cursor

Cursor AI 编程完全指南

Cursor 是基于 VS Code 深度定制的 AI 原生编程编辑器，内置 GPT-4o 和 Claude 3.5 Sonnet 等顶级模型。它颠覆了传统编程方式——你不再需要逐行编写代码，而是通过自然语言对话和智能补全来完成开发工作。Cursor 可以理解整个代码库的上下文，实现跨文件代码生成、智能重构、Bug修复和架构建议。

一、Cursor 核心功能全景

二、Composer — Cursor 的灵魂功能

2.1 Composer vs Chat 的区别

2.2 Composer 最佳实践

1. 先小后大：先让Composer改一个小函数，验证它理解了代码风格，再放大任务范围
2. 分步执行：不要一次描述整个功能，分步骤提出：先创建数据结构→再实现业务逻辑→最后写UI
3. 善用拒绝：对不满意的diff果断Reject，给出更具体的指令重新生成
4. 结合Chat：在Chat中讨论方案和架构，确认后在Composer中执行实现

三、.cursorrules 项目规则配置指南

在项目根目录创建 .cursorrules 文件，Cursor 会自动读取并遵守其中的规则：

你是一个[技术栈]的高级开发者。请严格遵守以下规范：

代码风格：
- 使用[TypeScript/JavaScript/Python]编写
- 命名规范：[camelCase/PascalCase/snake_case]
- 每个函数添加[JSDoc/docstring]注释
- 文件组织：[按功能/按类型]组织目录结构
- 导出方式：[命名导出/默认导出]

技术约定：
- 状态管理使用[方案]
- 样式编写使用[方案]
- API请求统一使用[封装的工具函数]
- 错误处理：[统一try-catch/错误边界]
- 类型定义：[interface/type/class]

测试要求：
- 所有新功能必须包含单元测试
- 测试文件放在[目录]
- 使用[测试框架]编写测试

禁止事项：
- 不要使用any类型
- 不要引入未在package.json中的依赖
- 不要创建超过200行的组件
- 不要使用魔法数字，使用常量定义

四、Agent 模式高级用法

Agent 模式是 Cursor 最强大的功能，让 AI 可以自主执行终端命令、读写多个文件、甚至启动开发服务器来验证代码：

Task: 为项目添加用户认证功能

请按以下步骤执行：
1. 先阅读项目现有的代码结构，了解使用的框架和代码风格
2. 创建认证相关的类型定义文件
3. 实现登录/注册/登出的API接口
4. 创建认证中间件和状态管理
5. 实现登录表单和用户状态展示组件
6. 运行项目确保新增代码不破坏现有功能
7. 如有编译错误，自行修复

技术栈：React + TypeScript + JWT
要求：完整错误处理、加载状态、表单验证、响应式设计

五、Cursor 与其他 AI 编程工具对比

六、效率翻倍的进阶技巧

1. Notepads作为持久记忆：在Notepads中存储项目的架构决策、API约定、命名规范等，Cursor会在所有对话中自动参考这些内容
2. @Codebase精确搜索：使用"@Codebase 用户认证是怎么实现的"来快速了解现有功能，避免重复造轮子
3. 终端命令生成：在终端中按Cmd+K，用自然语言描述你想执行的命令
4. 多模型切换：编程和代码生成用Claude 3.5 Sonnet（代码能力最强），架构讨论和方案设计用GPT-4o（思路更广），快速补全用Cursor Small（本地模型，速度最快）
5. 图片转代码：将UI设计截图粘贴到Chat中，Cursor可以直接生成对应的前端代码