Cursor AI 编程完全指南
什么是 Cursor
Cursor 是一个基于 VS Code 的 AI 编程编辑器，内置了 AI 代码补全、对话、编辑等功能。它是目前最流行的 AI IDE 之一。
安装与配置
- 访问 cursor.com 下载
- 安装后可以导入 VS Code 的设置和扩展
- 登录 Cursor 账号（免费版每月有限额）
订阅方案
| 方案 | 价格 | 包含 |
|---|---|---|
| Free | $0/月 | 2000 次补全 + 50 次高级请求 |
| Pro | $20/月 | 无限补全 + 500 次高级请求 |
| Business | $40/月 | 团队管理 + 更多配额 |
核心功能
1. Tab 补全
Cursor 会在你打字时自动预测下一段代码，按 Tab 接受。
技巧：
- 写好函数签名和注释，补全质量更高
- 按
Cmd+→可以逐词接受补全 - 不满意时继续打字，补全会自动更新
2. Cmd+K 内联编辑
选中代码后按 Cmd+K，输入指令直接修改代码。
常用场景：
- "Add error handling"
- "Convert to TypeScript"
- "Optimize this function"
- "Add JSDoc comments"
3. Chat 面板（Cmd+L）
侧边栏对话面板，可以问问题、讨论代码。
技巧：
- 用
@引用文件：@src/utils.ts - 用
@引用文档：@docs - 用
@引用代码库：@codebase - 选中代码后打开 Chat，自动包含选中内容
4. Composer Agent 模式（Cmd+I）
最强大的功能 — AI 可以��主修改多个文件，像一个 pair programmer。
使用方式：
- 按
Cmd+I打开 Composer - 描述你要做的事情
- AI 会分析代码库，提出修改方案
- 你可以逐个接受或拒绝修改
适合的任务：
- 添加新功能（跨多个文件）
- 重构代码
- 修复 Bug
- 添加测试
项目配置：.cursorrules
在项目根目录创建 .cursorrules 文件，定义项目级的 AI 行为规则。
# .cursorrules
You are working on a Next.js 15 project with TypeScript.
Tech stack:
- Next.js 15 (App Router)
- TypeScript 5
- Tailwind CSS v4
- Prisma ORM
- shadcn/ui
Conventions:
- Use functional components with hooks
- Prefer server components, use "use client" only when needed
- Use Tailwind for styling, no CSS modules
- API routes return JSON with consistent error format
- Database queries go through Prisma, never raw SQL
File structure:
- src/app/ — routes (thin layer)
- src/modules/ — business logic
- src/modules/shared/ — shared utilities
模型选择
Cursor 支持多种 AI 模型：
| 模型 | 适合 | 速度 |
|---|---|---|
| Claude Sonnet 4 | 日常编码（推荐） | 快 |
| Claude Opus 4 | 复杂架构设计 | 慢 |
| GPT-4o | 通用编码 | 快 |
| cursor-small | 简单补全 | 最快 |
建议：日常用 Claude Sonnet 4，复杂任务切 Opus 4。
Cursor vs Claude Code
| 维度 | Cursor | Claude Code |
|---|---|---|
| 形态 | GUI IDE | CLI 终端 |
| 编辑方式 | 可视化 diff | 直接写文件 |
| 适合 | 交互式开发 | 自动化任务 |
| 上下文 | 手动 @ 引用 | 自动分析 |
| 多文件 | Composer 模式 | 原生支持 |
| 价格 | $20/月起 | 按 API 用量 |
两者互补：Cursor 适合日常交互式开发，Claude Code 适合大规模自动化任务（如重构、迁移）。
高级技巧
1. 用 @codebase 搜索
@codebase 这个项目的认证是怎么实现的？
Cursor 会搜索整个代码库，找到相关文件后回答。
2. 用 @docs 引用文档
@docs(Next.js) 如何在 App Router 中实现中间件？
3. 多文件编辑工作流
- 先用 Chat 讨论方案
- 确认后切到 Composer
- 让 AI 生成所有文件的修改
- 逐个 review 和接受
4. 自定义快捷键
在 Settings → Keyboard Shortcuts 中自定义：
Cmd+K：内联编辑Cmd+L：打开 ChatCmd+I：打开 Composer